Skip to main content

​
When to use

Fetch account details after creation or when you only have the entityId (returned by create-user). Works for both USER and BUSINESS entities.

​
Endpoint

  • GET {{ACCOUNT_URL}}/v1/ext/account/:entityId
  • Auth: Bearer {{accessToken}}
  • Path param: entityId (use account.id from create)

​
Request

curl -X GET "{{ACCOUNT_URL}}/v1/ext/account/{{entityId}}" \
  -H "Authorization: Bearer {{accessToken}}"

​
Response (200)

{
  "externalId": "6aded2a6-0f9c-4a5d-baaf-56b15d384e45",
  "account": {
    "id": "NmFkZWQyYTYtMGY5Yy00YTVkLWJhYWYtNTZiMTVkMzg0ZTQ1",
    "firstName": "Delphine",
    "lastName": "Connelly",
    "email": "Javonte_Ernser@example.org",
    "confirmed": false,
    "createdAt": "2024-07-17T07:04:50.264Z",
    "deletedAt": null
  },
  "association": {
    "businessId": "d5e6f1dd-57bc-4581-98e8-646264a5f2c9",
    "role": "USER"
  }
}

​
Notes

  • externalId can be the identifier you supplied; account.id is CentryOS internal.
  • Use this to confirm onboarding, populate dashboards, or check associations.