> ## Documentation Index
> Fetch the complete documentation index at: https://docs.centryos.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Account Metadata

> Retrieve account details (user or business) by entityId.

## 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

```bash theme={null}
curl -X GET "{{ACCOUNT_URL}}/v1/ext/account/{{entityId}}" \
  -H "Authorization: Bearer {{accessToken}}"
```

## Response (200)

```json theme={null}
{
  "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.