# List accounts

Endpoint: GET /v1/domains/{domainId}/accounts
Security: httpAuth

## Security:

  - `httpAuth` (unknown)
    http bearer

## Path parameters:

  - `domainId` (string, required)
    Unique identifier for the domain.

## Query parameters:

  - `limit` (integer)
    The number of entities to return.

  - `startingAfter` (string)
    Entity id used to the determine beginning of query results.

  - `sortBy` (string)
    Property name used to sort the query results.

  - `sortOrder` (string)
    Sort order applied to the query results.

  - `ledgerId` (string)
    Return entities matching given default ledger id.

  - `alias` (string)
    Return entities with aliases that contains or equals to provided alias.

  - `providerDetails.vaultId` (string)
    Return entities matching given vault id.

  - `metadata.createdBy` (string)
    Return entities that were created by matching user.

  - `metadata.lastModifiedBy` (string)
    Return entities that were last modified by matching user.

  - `metadata.description` (string)
    Return entities with descriptions that contains or equals to provided description.

  - `metadata.customProperties` (array)
    Return entities that contains provided custom properties.

  - `lock` (array)
    Return entities matching given lock status(/-es).

  - `additionalDetails.processingStatus` (string)
    Return entities matching given processing status.

  - `additionalDetails.ledgers.ledgerId` (array)
    Return entities given ledger id.

  - `additionalDetails.ledgers.status` (array)
    Return entities having a ledger matching given status.

## Response 200 fields (application/json):

  - `items` (array, required)

  - `items.data` (object, required)

  - `items.data.id` (string, required)

  - `items.data.domainId` (string, required)

  - `items.data.alias` (string, required)

  - `items.data.ledgerId` (string)

  - `items.data.providerDetails` (any, required)

  - `items.data.providerDetails.vaultId` (string, required)

  - `items.data.providerDetails.keyStrategy` (string, required)
    Enum: "VaultHard", "VaultSoft", "Random"

  - `items.data.providerDetails.keyInformation` (any, required)

  - `items.data.providerDetails.keyInformation.publicKey` (any)

  - `items.data.providerDetails.keyInformation.publicKey.value` (string, required)

  - `items.data.providerDetails.keyInformation.publicKey.chainCode` (string, required)

  - `items.data.providerDetails.keyInformation.publicKey.type` (string, required)
    Enum: "ExtendedPublicKey", "PublicKey"

  - `items.data.providerDetails.keyInformation.type` (string, required)
    Enum: "Random", "VaultDerived"

  - `items.data.providerDetails.keyInformation.derivationPath` (string, required)

  - `items.data.providerDetails.keys` (array)

  - `items.data.providerDetails.keys.id` (string, required)
    Enum: "SECP256K1_CUSTODY_1", "ED25519_CUSTODY_1", "ED25519_CUSTODY_2", "ED25519_STAKING_1", "ED25519_CANTON_PARTY_1"

  - `items.data.providerDetails.keys.derivationPath` (string, required)

  - `items.data.providerDetails.keys.publicKey` (any)

  - `items.data.providerDetails.keys.publicKey.value` (string, required)

  - `items.data.providerDetails.keys.publicKey.chainCode` (string, required)

  - `items.data.providerDetails.keys.publicKey.type` (string, required)
    Enum: "ExtendedPublicKey"

  - `items.data.providerDetails.keys.type` (string, required)
    Enum: "VaultDerived", "VaultDerivedNonExtended", "VaultRandom", "VaultReserved"

  - `items.data.providerDetails.type` (string, required)
    Enum: "Vault"

  - `items.data.lock` (string, required)
    Enum: "Unlocked", "Locked", "Archived"

  - `items.data.metadata` (object, required)

  - `items.data.metadata.description` (string)

  - `items.data.metadata.revision` (integer, required)

  - `items.data.metadata.createdAt` (string, required)

  - `items.data.metadata.createdBy` (object)

  - `items.data.metadata.createdBy.id` (string, required)

  - `items.data.metadata.createdBy.domainId` (string, required)

  - `items.data.metadata.lastModifiedAt` (string, required)

  - `items.data.metadata.customProperties` (object, required)

  - `items.signature` (string, required)

  - `items.signingKey` (string, required)

  - `items.additionalDetails` (object)

  - `items.additionalDetails.processing` (any, required)

  - `items.additionalDetails.processing.status` (string, required)
    Enum: "Completed", "Interrupted", "Pending", "Preparing", "Recovering", "Tracked"

  - `items.additionalDetails.processing.reason` (string, required)

  - `items.additionalDetails.processing.hint` (string)
    Enum: "TransientIssue", "InternalError"

  - `items.additionalDetails.lastBalancesUpdateRequestedAt` (string)
    Deletion target: Mar. 31st 2027

  - `items.additionalDetails.lastBalancesUpdateProcessedAt` (string)
    Deletion target: Mar. 31st 2027

  - `items.additionalDetails.ledgers` (array, required)

  - `items.additionalDetails.ledgers.ledgerId` (string, required)

  - `items.additionalDetails.ledgers.lastBalancesUpdateRequestedAt` (string)

  - `items.additionalDetails.ledgers.lastBalancesUpdateProcessedAt` (string)

  - `items.additionalDetails.ledgers.status` (string, required)
    Enum: "Activated", "Activating", "Available", "AwaitingLedgerActivation", "Unavailable"

  - `items.additionalDetails.ledgers.processing` (any, required)

  - `items.additionalDetails.ledgers.processing.hint` (string)
    Enum: "TransientIssue", "InternalError"

  - `items.additionalDetails.ledgers.processing.status` (string, required)
    Enum: "Pending", "Preparing", "Recovering", "Tracked"

  - `count` (integer, required)

  - `currentStartingAfter` (string)

  - `nextStartingAfter` (string)

## Response 400:

  - `400` (unknown)
    One of: Domain locked (DomainLockedError); Requester locked (RequesterLockedError)

## Response 400 fields (application/json):

  - `reason` (string, required)

  - `message` (string)

## Response 401:

  - `401` (unknown)
    One of: Invalid JWT (InvalidJwtError); User not authorized (PermissionDeniedError)

## Response 401 fields (application/json):

  - `reason` (string, required)

  - `message` (string)

## Response 404:

  - `404` (unknown)
    Entity or Domain not found (EntityNotFoundError)

## Response 404 fields (application/json):

  - `reason` (string, required)

  - `message` (string)