Account Holders

Retrieve account holder

Changed on

Retrieves an account holder by ID.

get/v1/account_holders/{id}

Request

  • Base URL
    https://api.augustus.com
  • URL
    https://api.augustus.com/v1/account_holders/{id}
  • Auth
    HTTP bearer

Path parameters

idstring required
Example:68e0a1b2c3d4e5f60718293a

Unique identifier of the account holder.

Response

The account holder resource

idstring required

Unique identifier of the account holder.

type'account_holder' required

Resource type discriminator.

holder_type'natural_person' | 'business' required

Type of the account holder.

status'pending' | 'active' | 'closed' required

Current account holder status.

metadataobject required

Set of up to 50 key-value string pairs you can attach to store structured information, such as correlating this resource with an object in your own system. Keys may be up to 40 characters and values up to 500 characters.

created_atstring date-time required

ISO 8601 UTC timestamp when the account holder was created.

Example response

{
  "id": "68e0a1b2c3d4e5f60718293a",
  "beneficiary_data": {
    "legal_name": "Jordan Rivera",
    "residential_address": {
      "line_1": "548 Market St",
      "line_2": "Apartment 4B",
      "city": "San Francisco",
      "state": "CA",
      "postal_code": "94103"
    },
    "date_of_birth": "1990-01-15",
    "identification": {
      "value": "123-45-6789"
    }
  },
  "metadata": {
    "invoice_id": "INV-2026-0042"
  },
  "created_at": "2026-01-15T10:30:00Z"
}

Changes

  • f7ded6c181abRevision changes
    • info

      endpoint added

  • 8e304f78f67eRevision changes
    • info

      added subschema #1 subschema #2 to the ///// response property anyOf list for the response status

    • info

      removed subschema #1 subschema #2 from the ///// response property anyOf list for the response status