# Search for account

Endpoint: GET /account/{AccountIdentifier}
Version: 1.0.0-beta
Security: bearerToken

## Path parameters:

  - `AccountIdentifier` (string, required)
    Account identifier
    Example: "098B0A25"

## Query parameters:

  - `include` (string)
    Comma-separated values from optional response fields

## Response 200 fields (application/json):

  - `id` (integer, required)

  - `identifier` (string, required)
    Example: "0980A123"

  - `noOfUsers` (integer, required)

  - `status` (string, required)
    Ref.Data.ACCOUNT_STATUS
    Example: "APPROVED"

  - `maxUsers` (number, required)

  - `childAccounts` (array, required)

  - `registryLinks` (array, required)

  - `registryLinks.program` (string, required)
    Ref.Data.PROGRAM

  - `registryLinks.registryAccountId` (string, required)

  - `registryLinks.status` (string, required)
    Ref.Data.REGISTRY_LINK_STATUS

  - `registryLinks.lastSyncDate` (string,null)
    Incremental sync watermark (RFC 3339 date-time), equivalent to the server's sync time identifier used for incremental sync. Omitted or null when the registry link has never been synced.

  - `organization` (object, required)

  - `organization.iamOrgId` (string)

  - `organization.legalName` (string, required)
    Example: "RVCMC Sub Default"

  - `organization.structure` (string, required)
    Ref.Data.ORGANIZATION_LEGAL_STRUCTURE
    Example: "PRIVATELY_OWNED_CORP"

  - `organization.type` (string, required)
    Ref.Data.ORGANIZATION_TYPE
    Example: "BROKER"

  - `services` (array, required)
    Service accounts for this EMA account. Each item is an AccountService

  - `services.status` (string, required)
    Ref.Data.SERVICE_ACCOUNT_STATUS
    Example: "APPROVED"

  - `services.type` (string, required)
    Ref.Data.SERVICE_TYPE
    Example: "ACX"

  - `services.attributes` (any, required)
    Shape is determined by the parent service type (Ref.ServiceType), using mapping: ACX → AcxAccountServiceAttributes; SUBACCOUNT_SERVICE → SubaccountAccountServiceAttributes; CUSTODIAN_SERVICE → CustodianAccountServiceAttributes; types in NoTypedAttributesServiceAccountType → NoAccountServiceAttributes (empty object).

## Response 400 fields (application/json):

  - `code` (string)
    Enum: "INVALID_REQUEST"

  - `message` (string)

## Response 401 fields (application/json):

  - `message` (string)

## Response 500 fields (application/json):

  - `message` (string)