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

# Get Portal

> Retrieve a single claim portal by ID, including its claim config and auth settings.



## OpenAPI

````yaml /apis/admin/openapi.json get /api/external/v1/portals/{id}
openapi: 3.1.0
info:
  title: Magna Admin API
  version: 1.0.0
  description: >-
    The private, server-to-server API for managing allocations, funding and
    claims, transactions, portals, and token data. Authenticated with a project
    API key sent in the `x-magna-api-token` header.
servers:
  - url: https://app.magna.so
    description: Production
security:
  - apiToken: []
paths:
  /api/external/v1/portals/{id}:
    get:
      tags:
        - Portals
      summary: Get Portal
      description: >-
        Retrieve a single claim portal by ID, including its claim config and
        auth settings.
      operationId: getPortalsById
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type:
              - string
            minLength: 1
            format: uuid
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  isProcessed:
                    type: boolean
                  result:
                    description: Endpoint-specific result payload.
              example:
                isProcessed: true
                result:
                  id: po...uuid
                  name: Acme Claim Portal
                  projectId: p...uuid
                  domains:
                    - acme.demo-portal.magna.so
                  legalEntityName: Acme Inc.
                  version: V2
                  configuration:
                    ...: version-specific portal configuration
                  createdAt: '2024-04-15T21:26:21.000Z'
                  updatedAt: '2024-04-15T21:26:21.000Z'
                  claimConfig:
                    tokenId: tok...uuid
                    contractId: c...uuid
                    startTimestamp: '2024-05-01T00:00:00.000Z'
                    endTimestamp: null
                  auth:
                    magnaApiToken: null
                    terminal3: null
                    x: null
        '400':
          description: Validation error
        '401':
          description: Missing or invalid API token
        '403':
          description: API token lacks the required scope or project access
components:
  securitySchemes:
    apiToken:
      type: apiKey
      in: header
      name: x-magna-api-token

````