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

# `GET /v1/control/invitations/{token}`: what this invitation is for.

> Unauthenticated by necessity - the invitee has no account yet. It reveals
only the address the invitation was already sent to and the role it grants,
and an unknown token is a flat `404` rather than anything that would let
somebody probe for live tokens.
# Errors

Returns `404` for a token that is unknown, expired or already used - the
same answer for each, so this cannot be used to probe for live tokens -
and `503` when the invitation store cannot be read.



## OpenAPI

````yaml /openapi.json get /v1/control/invitations/{token}
openapi: 3.1.0
info:
  title: Esectra API
  description: >-
    Transaction screening, identity verification, and wallet risk.


    Every create route accepts `Idempotency-Key`; replaying one returns the
    original record with `200` where the first call returned `201`. `POST
    /v1/transactions` requires the header, because a duplicated transaction is a
    duplicated financial record.
  license:
    name: proprietary
    identifier: proprietary
  version: 0.1.0
servers:
  - url: https://qa.esectra.com
    description: Esectra QA Documentation
security: []
paths:
  /v1/control/invitations/{token}:
    get:
      tags:
        - Control
      summary: '`GET /v1/control/invitations/{token}`: what this invitation is for.'
      description: >-
        Unauthenticated by necessity - the invitee has no account yet. It
        reveals

        only the address the invitation was already sent to and the role it
        grants,

        and an unknown token is a flat `404` rather than anything that would let

        somebody probe for live tokens.

        # Errors


        Returns `404` for a token that is unknown, expired or already used - the

        same answer for each, so this cannot be used to probe for live tokens -

        and `503` when the invitation store cannot be read.
      operationId: invitation_preview_handler
      parameters:
        - name: token
          in: path
          description: Invitation token
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Address invited and role granted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InvitationPreviewBody'
        '404':
          description: Unknown, expired or already-used token
        '503':
          description: A backing store could not be reached
components:
  schemas:
    InvitationPreviewBody:
      type: object
      description: What an invitee is shown before they accept.
      required:
        - email
        - role
      properties:
        email:
          type: string
          description: Address the invitation was sent to.
        role:
          type: string
          description: Role it grants.

````