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

# List all invitations across every account of the authenticated integrator

> Returns invitations across all accounts owned by the integrator, paginated and ordered (DESC by default).



## OpenAPI

````yaml /api-reference/openapi-integrator.json get /v1/query/get-all-invitations
openapi: 3.0.3
info:
  title: Byzantine Integrator API
  description: Byzantine REST API for integrators.
  license:
    name: ''
  version: 0.2.0
servers:
  - url: https://sandbox.api.byzantine.fi
    description: Sandbox
security: []
tags:
  - name: API health
    description: Check API status.
  - name: Customer management
    description: Endpoints to create, update, and retrieve customer information.
  - name: Account management
    description: Endpoints to manage accounts, bank accounts, invitations, and user roles.
  - name: Products
    description: Endpoints to get data about products and vaults.
  - name: Transactions
    description: Endpoints to create and manage transactions.
  - name: OTP authentication
    description: Endpoints to initialize and manage user authentication with OTP.
  - name: Events
    description: Endpoints to list lifecycle events.
  - name: Webhooks
    description: Integrator-managed outbound webhook subscriptions and delivery history.
  - name: Integrator key management
    description: >-
      Endpoints to inspect the current integrator credential scope, create,
      update and delete integrator keys.
paths:
  /v1/query/get-all-invitations:
    get:
      tags:
        - Account management
      summary: >-
        List all invitations across every account of the authenticated
        integrator
      description: >-
        Returns invitations across all accounts owned by the integrator,
        paginated and ordered (DESC by default).
      operationId: get_all_invitations
      parameters:
        - name: X-Pubkey
          in: header
          description: >-
            Integrator's ECDSA public key (P-256 curve, compressed SEC1 format).
            Example:
            0x038fedef7c12f93bbf342ad8943b7a825a3b41f61c9dc118b2c718efebabbf62fd
          required: true
          schema:
            type: string
        - name: X-Timestamp
          in: header
          description: >-
            Unix timestamp in seconds (UTC). Must be within tolerance window (1
            minute) to prevent replay attacks. Example: 1760375826
          required: true
          schema:
            type: string
        - name: X-Signature
          in: header
          description: >-
            ECDSA signature (DER-encoded, hex with 0x prefix). Signs the
            message: {timestamp}{METHOD}{path_and_query}{json_body}. Example:
            0x3045022100...
          required: true
          schema:
            type: string
        - name: limit
          in: query
          description: Page size (max 100). Defaults to 20.
          required: false
          schema:
            type: integer
            format: int64
            nullable: true
        - name: offset
          in: query
          description: Number of records to skip. Defaults to 0.
          required: false
          schema:
            type: integer
            format: int64
            nullable: true
        - name: order
          in: query
          description: >-
            Sort order over the field `updatedAt`. `desc` (default) returns the
            most recently updated first;

            `asc` returns the oldest first. Combine with `offset` to paginate
            through every invitation.
          required: false
          schema:
            $ref: '#/components/schemas/SortOrder'
      responses:
        '200':
          description: Invitations retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetAllInvitationsResponse'
        '400':
          description: Bad request
        '500':
          description: Internal server error
      security:
        - integrator_auth: []
components:
  schemas:
    SortOrder:
      type: string
      description: Chronological sort direction over the field `updatedAt`.
      enum:
        - asc
        - desc
    GetAllInvitationsResponse:
      type: object
      required:
        - invitations
        - total
        - limit
        - offset
      properties:
        invitations:
          type: array
          items:
            $ref: '#/components/schemas/GetInvitationResponse'
        total:
          type: integer
          format: int64
          description: Total number of invitations for this integrator across all accounts.
          example: 342
        limit:
          type: integer
          format: int64
          description: Page size (max 100). Defaults to 20.
          example: 20
        offset:
          type: integer
          format: int64
          description: Number of records to skip. Defaults to 0.
          example: 0
    GetInvitationResponse:
      type: object
      required:
        - invitation_id
        - account_id
        - account_name
        - user_id
        - role
        - first_name
        - last_name
        - user_email
        - inviter_id
        - inviter_first_name
        - inviter_last_name
        - status
        - created_at
        - updated_at
      properties:
        invitation_id:
          $ref: '#/components/schemas/Uuid'
        account_id:
          $ref: '#/components/schemas/Uuid'
        account_name:
          type: string
        user_id:
          $ref: '#/components/schemas/Uuid'
        role:
          $ref: '#/components/schemas/AccountUserRole'
        first_name:
          type: string
        last_name:
          type: string
        user_email:
          type: string
        inviter_id:
          $ref: '#/components/schemas/Uuid'
        inviter_first_name:
          type: string
        inviter_last_name:
          type: string
        status:
          $ref: '#/components/schemas/InvitationStatus'
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
    Uuid:
      type: string
      format: uuid
      description: A UUID string
      example: 550e8400-e29b-41d4-a716-446655440000
    AccountUserRole:
      type: string
      description: Role of a user in an account.
      enum:
        - root
        - admin
        - view
        - self_custodial
        - beneficiary
      example: root
    InvitationStatus:
      type: string
      description: Status of an invitation.
      enum:
        - pending
        - accepted
        - rejected
        - cancelled
      example: pending
  securitySchemes:
    integrator_auth:
      type: apiKey
      in: header
      name: X-Pubkey, X-Timestamp, X-Signature

````