# List Contacts

Get a list of all contacts in an organization.

Endpoint: GET /api/v1/addressbook/contacts
Version: 0.2.0
Security: bearerAuth

## Query parameters:

  - `sort_by` (array)
    Enum: "created_at_asc", "created_at_desc", "modified_at_asc", "modified_at_desc", "name_asc", "name_desc"

  - `page` (integer)
    The page number to fetch.

  - `size` (integer)
    The number of items per page.

  - `contact_ids` (array)
    The contact IDs to filter by.

  - `names` (array)
    The names to filter by.

  - `states` (array)
    The states to filter by.
    Enum: "pending", "active", "deleted"

  - `chain_types` (array)
    The chain types to filter by.
    Enum: "aptos", "cosmos", "evm", "exchange", "solana", "stacks", "starknet", "sui", "ton", "tron", "utxo"

  - `chains` (array)
    The chain unique ids to filter by.

  - `asset_ids` (array)
    List of asset identifiers to filter on.

  - `address_group_ids` (array)
    The address group IDs to filter by.

  - `exclude_address_group_ids` (array)
    List of address group IDs to exclude.

  - `exclude_contact_ids` (array)
    List of contact IDs to exclude.

## Response 200 fields (application/json):

  - `total` (integer, required)

  - `page` (integer, required)

  - `size` (integer, required)

  - `contacts` (array, required)

## Response 400 fields (application/json):

  - `title` (string, required)
    Human-readable error message.

  - `detail` (string, required)
    Detailed error message.

  - `full_detail` (string)
    Full error message with additional details, if available.

  - `request_id` (string)
    Request ID - for debugging purposes.

  - `system_error_code` (string)
    An additional system error code in Fordefi.

## Response 401 fields (application/json):

  - `title` (string, required)
    Human-readable error message.

  - `detail` (string, required)
    Detailed error message.

  - `full_detail` (string)
    Full error message with additional details, if available.

  - `request_id` (string)
    Request ID - for debugging purposes.

## Response 403 fields (application/json):

  - `title` (string, required)
    Human-readable error message.

  - `detail` (string, required)
    Detailed error message.

  - `full_detail` (string)
    Full error message with additional details, if available.

  - `request_id` (string)
    Request ID - for debugging purposes.

## Response 408 fields (application/json):

  - `title` (string, required)
    Human-readable error message.

  - `detail` (string, required)
    Detailed error message.

  - `full_detail` (string)
    Full error message with additional details, if available.

  - `request_id` (string)
    Request ID - for debugging purposes.

## Response 422 fields (application/json):

  - `title` (string, required)
    Human-readable error message.

  - `detail` (array, required)

  - `detail.loc` (array, required)

  - `detail.msg` (string, required)

  - `detail.type` (string, required)

  - `full_detail` (string)
    Full error message with additional details, if available.

  - `request_id` (string)
    Request ID - for debugging purposes.

## Response 500 fields (application/json):

  - `title` (string, required)
    Human-readable error message.

  - `detail` (string, required)
    Detailed error message.

  - `full_detail` (string)
    Full error message with additional details, if available.

  - `request_id` (string)
    Request ID - for debugging purposes.