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

# List marketing signups

> `export_customer_information` permission required.

All successful responses include `X-Request-Id` and `Cache-Control: private, no-store`. Requests are limited to 120 per minute.



## OpenAPI

````yaml /openapi.json get /tenants/{tenant}/customers/marketing-signups
openapi: 3.1.0
info:
  title: Gift Voucher Brilliance External API
  version: 1.0.0
  description: >-
    Read-only synchronisation and controlled voucher redemption for approved
    integrations. All operations require a bearer token. The API is limited to
    120 requests per minute per token/IP combination.
  contact:
    name: Gift Voucher Brilliance Support
    url: https://docs.giftvoucherbrilliance.co.uk/support
servers:
  - url: https://app.giftvoucherbrilliance.co.uk/api/external/v1
    description: Production
  - url: https://app.gvb-staging.co.uk/api/external/v1
    description: Staging
  - url: https://app.gvb.test/api/external/v1
    description: Local
security:
  - bearerAuth: []
tags:
  - name: Tenants
    description: Discover tenants available to the token.
  - name: Catalog
    description: Synchronise voucher products and categories.
  - name: Sales
    description: Synchronise purchased vouchers and balances.
  - name: Customers
    description: Export customers who opted in to marketing.
  - name: Redemptions
    description: Resolve, validate, and redeem vouchers.
paths:
  /tenants/{tenant}/customers/marketing-signups:
    get:
      tags:
        - Customers
      summary: List marketing signups
      description: >-
        `export_customer_information` permission required.


        All successful responses include `X-Request-Id` and `Cache-Control:
        private, no-store`. Requests are limited to 120 per minute.
      operationId: listMarketingSignups
      parameters:
        - name: tenant
          in: path
          required: true
          description: Authorised tenant identifier from the tenant directory.
          schema:
            type: integer
        - name: updated_since
          in: query
          description: Return records updated at or after this ISO-8601 timestamp.
          schema:
            type:
              - string
              - 'null'
            format: date-time
        - name: cursor
          in: query
          description: >-
            Opaque cursor from `next_cursor`; do not inspect or modify it. Page
            size is fixed at 50.
          schema:
            type:
              - string
              - 'null'
        - name: Accept
          in: header
          required: true
          description: Must be `application/json`.
          schema:
            type: string
            enum:
              - application/json
          example: application/json
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MarketingSignupCollection'
          headers:
            X-Request-Id:
              description: Request correlation identifier.
              schema:
                type: string
            Cache-Control:
              description: Sensitive responses are not shared or stored.
              schema:
                type: string
              example: private, no-store
        '401':
          description: Unauthenticated or invalid bearer token.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageError'
        '403':
          description: Token lacks the required tenant access or permission.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageError'
        '404':
          description: Resource or tenant was not found in the authorised scope.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageError'
        '422':
          description: Request validation failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationError'
        '429':
          description: Rate limit exceeded. Retry after the window resets.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageError'
components:
  schemas:
    MarketingSignupCollection:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/MarketingSignup'
        next_cursor:
          type:
            - string
            - 'null'
        server_time:
          type: string
          format: date-time
          description: ISO-8601 timestamp.
      required:
        - data
        - next_cursor
        - server_time
      title: MarketingSignupCollection
    MessageError:
      type: object
      properties:
        message:
          type: string
      required:
        - message
      title: MessageError
    ValidationError:
      type: object
      properties:
        message:
          type: string
        errors:
          type: object
          additionalProperties:
            type: array
            items:
              type: string
      required:
        - message
        - errors
      title: ValidationError
    MarketingSignup:
      type: object
      properties:
        id:
          type: integer
        forename:
          type:
            - string
            - 'null'
        surname:
          type:
            - string
            - 'null'
        full_name:
          type:
            - string
            - 'null'
        email:
          type: string
          format: email
        phone_number:
          type:
            - string
            - 'null'
        address_1:
          type:
            - string
            - 'null'
        address_2:
          type:
            - string
            - 'null'
        town:
          type:
            - string
            - 'null'
        city:
          type:
            - string
            - 'null'
        county:
          type:
            - string
            - 'null'
        country:
          type:
            - string
            - 'null'
        countryiso2:
          type:
            - string
            - 'null'
        postcode:
          type:
            - string
            - 'null'
        marketing_opted:
          type: boolean
        created_at:
          type:
            - string
            - 'null'
          format: date-time
          description: ISO-8601 timestamp.
        updated_at:
          type:
            - string
            - 'null'
          format: date-time
          description: ISO-8601 timestamp.
      required:
        - id
        - email
        - marketing_opted
        - created_at
        - updated_at
      title: MarketingSignup
  securitySchemes:
    bearerAuth:
      type: http
      description: Bearer token created in the GVB API Access page.
      scheme: bearer

````