API reference › Profiles › Get profile

Get a profile

GET/v1/profiles/:key

Returns the current version only — the one a new registration against this key would pin to. There is no endpoint that lists every past version; a domain that is already registered keeps its own profileVersionId regardless of what this call returns later, which is the whole point of versioning. See Profiles and versions.

Field	Type	Description
key*	string	The profile's identifier, as given to POST /v1/profiles.

No CLI command yet — reading a profile back is API-only.

curl -s https://api.propgate.dev/v1/profiles/sending \
  -H "authorization: Bearer pg_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

{
  "data": {
    "id": "019fcf6b-1a2b-7c3d-8e4f-5a6b7c8d9e0f",
    "key": "sending",
    "object": "profile",
    "requirements": [
      {
        "key": "ns",
        "check": "delegation"
      },
      {
        "key": "spf",
        "check": "spf",
        "include": "_spf.google.com"
      },
      {
        "key": "dkim",
        "check": "dkim",
        "selector": "google"
      },
      {
        "key": "dmarc",
        "check": "dmarc"
      },
      {
        "key": "mail",
        "check": "mx",
        "expectsMail": true
      }
    ],
    "version": 2
  },
  "error": null,
  "meta": null
}

A key with no version yet is a 404, quoted from the same route:

{
  "data": null,
  "error": {
    "message": "no profile named \"sending\""
  },
  "meta": null
}