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

# Get a form contact with their responses and bookings

> **Beta** — this endpoint may change before general availability.



## OpenAPI

````yaml /api-reference/openapi.json get /form-contacts/{contactId}
openapi: 3.1.0
info:
  title: Replo Public API
  version: '2026-11-10'
servers:
  - url: https://api.replo.app/v1
security: []
paths:
  /form-contacts/{contactId}:
    get:
      tags:
        - Form-contacts
      summary: Get a form contact with their responses and bookings
      description: '**Beta** — this endpoint may change before general availability.'
      operationId: form-contacts.get
      parameters:
        - name: Replo-Api-Version
          in: header
          required: true
          schema:
            type: string
            enum:
              - '2026-11-10'
          description: The public API version to use for this request.
        - schema:
            type: string
            format: uuid
            description: The contact's id
          required: true
          description: The contact's id
          name: contactId
          in: path
        - schema:
            type: string
            format: uuid
            description: The project that owns the forms, from list_projects
          required: true
          description: The project that owns the forms, from list_projects
          name: projectId
          in: query
      responses:
        '200':
          description: Get a form contact with their responses and bookings
          content:
            application/json:
              schema:
                type: object
                properties:
                  object:
                    type: string
                    enum:
                      - form_contact
                  id:
                    type: string
                    format: uuid
                  email:
                    type: string
                  name:
                    type:
                      - string
                      - 'null'
                  phone:
                    type:
                      - string
                      - 'null'
                  projectId:
                    type: string
                    format: uuid
                  createdAt:
                    type: string
                  updatedAt:
                    type: string
                  responses:
                    type: array
                    items:
                      type: object
                      properties:
                        object:
                          type: string
                          enum:
                            - form_response
                        id:
                          type: string
                          format: uuid
                        projectId:
                          type: string
                          format: uuid
                        formId:
                          type: string
                          format: uuid
                        contactId:
                          type:
                            - string
                            - 'null'
                          format: uuid
                          description: >-
                            The person who answered, when the form asked for an
                            email
                        answers:
                          type: object
                          additionalProperties:
                            anyOf:
                              - type: string
                              - type: boolean
                              - type: number
                              - type: array
                                items:
                                  type: string
                                  maxLength: 255
                                maxItems: 100
                            description: >-
                              Text, a yes/no, a number or rating, or the choices
                              of a pick-several question
                          description: >-
                            Answers keyed by question key; a file answer is the
                            file's name
                        source:
                          type: string
                          enum:
                            - site
                            - manual
                          description: >-
                            site: sent from the website; manual: added by the
                            business
                        pagePath:
                          type:
                            - string
                            - 'null'
                        referrer:
                          type:
                            - string
                            - 'null'
                        utm:
                          type:
                            - object
                            - 'null'
                          properties:
                            utm_source:
                              type: string
                              maxLength: 255
                            utm_medium:
                              type: string
                              maxLength: 255
                            utm_campaign:
                              type: string
                              maxLength: 255
                            utm_term:
                              type: string
                              maxLength: 255
                            utm_content:
                              type: string
                              maxLength: 255
                          description: Campaign tags from the link the visitor landed on
                        waitlist:
                          type:
                            - object
                            - 'null'
                          properties:
                            serviceKey:
                              type: string
                            date:
                              type: string
                          required:
                            - serviceKey
                            - date
                          description: >-
                            Set when the visitor asked to hear about openings on
                            a full day instead of booking
                        createdAt:
                          type: string
                      required:
                        - object
                        - id
                        - projectId
                        - formId
                        - contactId
                        - answers
                        - source
                        - pagePath
                        - referrer
                        - utm
                        - waitlist
                        - createdAt
                    description: Their latest 200 responses, newest first
                  bookings:
                    type: array
                    items:
                      type: object
                      properties:
                        object:
                          type: string
                          enum:
                            - booking
                        id:
                          type: string
                          format: uuid
                        projectId:
                          type: string
                          format: uuid
                        serviceId:
                          type: string
                          format: uuid
                        staffId:
                          type: string
                          format: uuid
                        responseId:
                          type:
                            - string
                            - 'null'
                          format: uuid
                          description: >-
                            The form response the booking came with; null when
                            added by hand
                        status:
                          type: string
                          enum:
                            - held
                            - confirmed
                            - cancelled
                            - completed
                            - no_show
                          description: >-
                            confirmed, cancelled, completed or no_show; held is
                            a time a visitor is still filling in the form for
                        startsAt:
                          type: string
                        endsAt:
                          type: string
                        seats:
                          type: integer
                        meetingUrl:
                          type:
                            - string
                            - 'null'
                          description: The Google Meet link, if any
                        addOnKeys:
                          type: array
                          items:
                            type: string
                        contact:
                          type:
                            - object
                            - 'null'
                          properties:
                            id:
                              type: string
                              format: uuid
                            email:
                              type: string
                            name:
                              type:
                                - string
                                - 'null'
                            phone:
                              type:
                                - string
                                - 'null'
                          required:
                            - id
                            - email
                            - name
                            - phone
                          description: The person the booking is for
                        createdAt:
                          type: string
                      required:
                        - object
                        - id
                        - projectId
                        - serviceId
                        - staffId
                        - responseId
                        - status
                        - startsAt
                        - endsAt
                        - seats
                        - meetingUrl
                        - addOnKeys
                        - contact
                        - createdAt
                    description: Up to 200 of their bookings, earliest start first
                required:
                  - object
                  - id
                  - email
                  - name
                  - phone
                  - projectId
                  - createdAt
                  - updatedAt
                  - responses
                  - bookings
        '400':
          description: Invalid request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicApiError'
        '401':
          description: >-
            Missing or invalid Replo Public API token. Send an active key as
            `Authorization: Bearer replo_sk_...`; if it was revoked, create a
            new key in Replo Settings.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicApiError'
        '403':
          description: >-
            You are not authorized to access this resource. Ask a workspace
            owner to perform this action or to grant the key's creator access.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicApiError'
        '404':
          description: >-
            Not Found. The resource may not exist, this key may lack the
            required scope, or the key's creator may have lost access. Check the
            key's scopes in Replo Settings and the creator's project or
            workspace access; a workspace owner can grant access.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicApiError'
        '409':
          description: The resource is in a conflicting state.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicApiError'
        '413':
          description: File content exceeds the 10 MiB limit.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicApiError'
        '429':
          description: >-
            Too many requests. Please retry after the time indicated by the
            Retry-After header.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicApiError'
        '500':
          description: An internal error occurred.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicApiError'
        '503':
          description: Service temporarily unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicApiError'
      security:
        - bearerAuth: []
components:
  schemas:
    PublicApiError:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
            message:
              type: string
            doc_url:
              type: string
            issues:
              type: array
              items:
                type: object
                properties:
                  param:
                    type:
                      - string
                      - 'null'
                    description: >-
                      Dotted path to the failing field within the request body,
                      query or path, e.g. "name" or "variants.0.available"; null
                      when the rule covers the whole input.
                  message:
                    type: string
                    description: Why the field was rejected.
                required:
                  - param
                  - message
              description: >-
                Present on an invalid_request whose input failed validation:
                each failing field and why, at most 10.
          required:
            - code
            - message
            - doc_url
      required:
        - error
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.