---
title: "Retrieve an Account Type"
method: GET
path: "/account-types/{account-type-id}"
tags: ["accountTypes"]
---

# Retrieve an Account Type

`GET /account-types/{account-type-id}`

## Request

- Base URL: `https://api.withpersona.com/api/v1`
- URL: `https://api.withpersona.com/api/v1/account-types/{account-type-id}`
- Auth: HTTP bearer

Retrieves the details of an existing Account Type, including its configured field schemas.

## Path parameters

- `account-type-id` string, required

## Query parameters

- `include` string
- `fields` object

## Headers

- `Key-Inflection` 'camel' | 'kebab' | 'snake'
- `Idempotency-Key` string
- `Persona-Version` '2026-09-29' | '2025-12-08' | '2025-10-27' | '2023-01-05' | '2022-09-01' | '2021-08-18' | '2021-07-05' | '2021-02-21' | '2020-05-18': Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).

## Response `200`

This endpoint returns an Account Type object.

- AccountTypesRetrieveAnAccountTypeResponse200
  - `data` AccountType, required: An Account Type object
    - `id` string
    - `attributes` AccountsIncludedObjectsItemsDiscriminatorMappingAccountTypeAttributes
      - `name` string
      - `created-at` string, date-time
      - `updated-at` string, date-time, nullable
      - `field-schemas` FieldSchema[]
        - union
          - object: array variant
            - `type` 'array', required
            - `key` string
            - `label` string, nullable
            - `config` FieldSchemaArrayConfig
              - …
          - object: boolean variant
            - `type` 'boolean', required
            - `key` string
            - `label` string, nullable
            - `default-value` boolean, nullable
            - `config` FieldSchemaBooleanConfig
              - …
          - object: choices variant
            - `type` 'choices', required
            - `key` string
            - `label` string, nullable
            - `default-value` string, nullable: Must be one of the values in `config.options`, or null.
            - `config` FieldSchemaChoicesConfig
              - …
          - object: date variant
            - `type` 'date', required
            - `key` string
            - `label` string, nullable
            - `default-value` string, date, nullable
            - `config` FieldSchemaDateConfig
              - …
          - object: datetime variant
            - `type` 'datetime', required
            - `key` string
            - `label` string, nullable
            - `default-value` string, date-time, nullable
            - `config` FieldSchemaDatetimeConfig
              - …
          - object: email-address variant
            - `type` 'email-address', required
            - `key` string
            - `label` string, nullable
            - `default-value` string, nullable
            - `config` FieldSchemaEmailAddressConfig
              - …
          - object: file variant
            - `type` 'file', required
            - `key` string
            - `label` string, nullable
            - `config` FieldSchemaFileConfig
              - …
          - object: hash variant
            - `type` 'hash', required
            - `key` string
            - `label` string, nullable
            - `config` FieldSchemaHashConfig
              - …
          - object: integer variant
            - `type` 'integer', required
            - `key` string
            - `label` string, nullable
            - `default-value` integer, nullable
            - `config` FieldSchemaIntegerConfig
              - …
          - object: json variant
            - `type` 'json', required
            - `key` string
            - `label` string, nullable
            - `default-value` unknown
            - `config` FieldSchemaJsonConfig
              - …
          - object: multi-choices variant
            - `type` 'multi-choices', required
            - `key` string
            - `label` string, nullable
            - `default-value` string[], nullable: Each entry must be one of the values in `config.options`.
            - `config` FieldSchemaMultiChoicesConfig
              - …
          - object: number variant
            - `type` 'number', required
            - `key` string
            - `label` string, nullable
            - `default-value` number, double, nullable
            - `config` FieldSchemaNumberConfig
              - …
          - object: platform-file variant
            - `type` 'platform-file', required
            - `key` string
            - `label` string, nullable
            - `config` FieldSchemaPlatformFileConfig
              - …
          - object: string variant
            - `type` 'string', required
            - `key` string
            - `label` string, nullable
            - `default-value` string, nullable
            - `config` FieldSchemaStringConfig
              - …
          - object: relation-schema variant
            - `type` 'relation-schema', required
            - `key` string
            - `label` string, nullable
            - `config` FieldSchemaRelationConfig
              - …
    - `relationships` AccountsIncludedObjectsItemsDiscriminatorMappingAccountTypeRelationships
      - `account-statuses` AccountsIncludedObjectsItemsDiscriminatorMappingAccountTypeRelationshipsAccountStatuses
        - `data` AccountsIncludedObjectsItemsDiscriminatorMappingAccountTypeRelationshipsAccountStatusesDataItems[]
          - `type` 'account-status'
          - `id` string
      - `default-account-status` AccountsIncludedObjectsItemsDiscriminatorMappingAccountTypeRelationshipsDefaultAccountStatus
        - `data` AccountsIncludedObjectsItemsDiscriminatorMappingAccountTypeRelationshipsDefaultAccountStatusData
          - `type` 'account-status'
          - `id` string
  - `included` unknown[]: Excluded from the response by default. Will be an empty array when the `include` query parameter in the request was explicitly set to empty.
    - unknown

## Other responses

- `400`: The request was unacceptable, often due to invalid parameters.
- `401`: An invalid API key was provided.
- `403`: The given API key doesn’t have permissions to perform the request or a quota has been exceeded.
- `404`: The requested resource doesn’t exist.
- `429`: Your organization’s rate limit has been exceeded. We recommend an exponential backoff on requests.

---

[API](https://skmtc.dev/withpersona/apis/withpersona-2.md) - [All operations](https://skmtc.dev/withpersona/apis/withpersona-2/llms.txt) - [OpenAPI document](https://skmtc.dev/withpersona/apis/withpersona-2/revisions/f1c78133b3b2?raw)