> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usesend.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List contact books



## OpenAPI

````yaml get /v1/contactBooks
openapi: 3.0.0
info:
  version: 1.0.0
  title: useSend API
servers:
  - url: https://app.usesend.com/api
security: []
paths:
  /v1/contactBooks:
    get:
      responses:
        '200':
          description: Retrieve contact books accessible by the API key
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: string
                      description: The ID of the contact book
                      example: clx1234567890
                    name:
                      type: string
                      description: The name of the contact book
                      example: Newsletter Subscribers
                    teamId:
                      type: number
                      description: The ID of the team
                      example: 1
                    properties:
                      type: object
                      additionalProperties:
                        type: string
                      description: Custom properties for the contact book
                      example:
                        customField1: value1
                    variables:
                      type: array
                      items:
                        type: string
                      description: >-
                        Allowed personalization variables for contacts in this
                        book
                      example:
                        - registrationCode
                        - company
                    emoji:
                      type: string
                      description: The emoji associated with the contact book
                      example: 📙
                    doubleOptInEnabled:
                      type: boolean
                      description: Whether double opt-in is enabled for new contacts
                      example: true
                    doubleOptInFrom:
                      type: string
                      nullable: true
                      description: >-
                        From address used for double opt-in emails (must use a
                        verified domain)
                      example: Newsletter <hello@example.com>
                    doubleOptInSubject:
                      type: string
                      nullable: true
                      description: Subject line used for double opt-in confirmation email
                      example: Please confirm your subscription
                    doubleOptInContent:
                      type: string
                      nullable: true
                      description: >-
                        Email editor JSON content used for double opt-in
                        confirmation
                    createdAt:
                      type: string
                      description: The creation timestamp
                    updatedAt:
                      type: string
                      description: The last update timestamp
                    _count:
                      type: object
                      properties:
                        contacts:
                          type: number
                          description: The number of contacts in the contact book
                      required:
                        - contacts
                  required:
                    - id
                    - name
                    - teamId
                    - properties
                    - variables
                    - emoji
                    - createdAt
                    - updatedAt

````