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

# Get enrichment status

> Poll a v3 profile enrichment request until it completes or fails.

Returns the latest snapshot for a single-profile Enrich operation or one child of a batch operation.

```bash theme={"dark"}
curl "https://api.orbitsearch.com/v3/enrich/requests/$REQUEST_ID" \
  -H "Authorization: Bearer $ORBIT_API_KEY"
```

| Parameter    | Location | Required | Description                                                                                         |
| ------------ | -------- | -------- | --------------------------------------------------------------------------------------------------- |
| `request_id` | path     | Yes      | The request ID returned by `POST /v3/enrich/{profile_id}`, or a child request ID from batch Enrich. |

```json theme={"dark"}
{
  "request_id": "enrich-profile-123-full",
  "profile_id": "profile_123",
  "status": "completed",
  "operation": "full",
  "include_profile": true,
  "generation_level": 3,
  "profile": {
    "id": "profile_123",
    "displayName": "Example Person",
    "generationLevel": 3
  },
  "links": {
    "status": "/v3/enrich/requests/enrich-profile-123-full",
    "profile": "/v3/enrich/profile_123"
  }
}
```

Continue polling while `status` is `running`. Stop on `completed` or `failed`. This endpoint requires `search:read`; responses created with `include_profile: true` also require `profile:read`. Requests are visible only to the API key that created them.


## OpenAPI

````yaml openapi.json GET /v3/enrich/requests/{request_id}
openapi: 3.1.0
info:
  title: Orbit API
  version: 3.0.0
  description: Search for people and enrich known Orbit profiles.
servers:
  - url: https://api.orbitsearch.com
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Search
    description: Find people and poll search results.
  - name: Enrich
    description: Read or enrich known Orbit profiles.
  - name: Watchers
    description: Watch a profile on a schedule and read what each run found.
  - name: Webhooks
    description: Register endpoints that receive signed event deliveries.
paths:
  /v3/enrich/requests/{request_id}:
    get:
      tags:
        - Enrich
      summary: Get enrichment status
      description: >-
        Return the latest snapshot for one profile enrichment request. Poll
        while the status is `running`. Requires the `search:read` scope.
        Requests that include the profile also require `profile:read`.
      operationId: getEnrichmentStatus
      parameters:
        - $ref: '#/components/parameters/RequestId'
      responses:
        '200':
          description: The current enrichment snapshot.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EnrichSnapshot'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/RateLimited'
components:
  parameters:
    RequestId:
      name: request_id
      in: path
      required: true
      description: The request ID returned by a profile enrichment operation.
      schema:
        type: string
        minLength: 1
  schemas:
    EnrichSnapshot:
      type: object
      required:
        - request_id
        - profile_id
        - status
        - operation
        - include_profile
        - generation_level
        - links
      properties:
        request_id:
          type: string
        profile_id:
          type: string
        status:
          type: string
          enum:
            - running
            - completed
            - failed
        operation:
          $ref: '#/components/schemas/EnrichOperation'
        include_profile:
          type: boolean
        generation_level:
          oneOf:
            - type: integer
              minimum: 1
            - type: 'null'
        profile:
          $ref: '#/components/schemas/PublicProfile'
        failure:
          $ref: '#/components/schemas/Failure'
        links:
          $ref: '#/components/schemas/EnrichLinks'
    EnrichOperation:
      type: string
      enum:
        - partial
        - full
        - regenerate
      description: >-
        Use `partial` for a useful profile, `full` for the deepest available
        profile, or `regenerate` to rebuild a fresh full profile.
    PublicProfile:
      type: object
      description: >-
        The public Orbit profile. Available fields depend on the profile
        generation level.
      required:
        - id
        - generationLevel
        - avatarUrl
        - verified
        - sections
        - sources
      additionalProperties: true
      properties:
        id:
          type: string
        displayName:
          type: string
        personName:
          type: string
        aliases:
          type: array
          items:
            type: string
        generationLevel:
          oneOf:
            - type: integer
              minimum: 1
              maximum: 3
            - type: 'null'
        avatarUrl:
          oneOf:
            - type: string
              format: uri
            - type: 'null'
        profileUrl:
          type: string
          format: uri
        slug:
          type: string
        category:
          type: object
          required:
            - id
            - label
          properties:
            id:
              type: string
            label:
              type: string
        verified:
          type: boolean
        location:
          type: object
          properties:
            city:
              type: string
            region:
              type: string
            country:
              type: string
        headline:
          type: object
          properties:
            jobTitle:
              type: string
            companyName:
              type: string
            schoolName:
              type: string
        emails:
          type: array
          items:
            type: string
            format: email
        phoneNumbers:
          type: array
          items:
            type: string
        addresses:
          type: array
          items:
            type: object
            additionalProperties: true
        sections:
          type: object
          description: >-
            Structured profile sections. Standard sections are objects with
            section-specific items, or null when no public data is available.
            Items can carry item-level sources that map each item to its
            supporting evidence.
          additionalProperties:
            oneOf:
              - type: 'null'
              - type: object
                description: >-
                  A content section: items plus an optional deduplicated
                  section-level sources union.
                required:
                  - items
                additionalProperties: true
                properties:
                  items:
                    type: array
                    items:
                      type: object
                      additionalProperties: true
                      properties:
                        sources:
                          type: array
                          description: >-
                            Public evidence for this item only. Each source can
                            include excerpt chunks that support the item.
                            Omitted when no evidence is attributed to the item.
                          items:
                            $ref: '#/components/schemas/Source'
                  sources:
                    type: array
                    description: Deduplicated union of the evidence for the whole section.
                    items:
                      $ref: '#/components/schemas/Source'
              - type: object
                description: >-
                  The bio section: a public profile summary with optional
                  sources instead of items.
                required:
                  - bio
                additionalProperties: true
                properties:
                  bio:
                    type: string
                  sources:
                    type: array
                    description: Deduplicated union of the evidence for the whole section.
                    items:
                      $ref: '#/components/schemas/Source'
        sources:
          type: array
          description: Deduplicated and sanitized public sources used across the profile.
          items:
            $ref: '#/components/schemas/Source'
    Failure:
      type: object
      required:
        - code
        - message
        - retryable
        - reason
      properties:
        code:
          type: string
        message:
          type: string
        retryable:
          type: boolean
        reason:
          type: string
        suggested_inputs:
          type: array
          items:
            type: string
    EnrichLinks:
      type: object
      required:
        - profile
      properties:
        status:
          type: string
          description: Relative URL for the enrichment status endpoint.
        profile:
          type: string
          description: Relative URL for the profile-read endpoint.
    ErrorResponse:
      type: object
      required:
        - status
        - error
      properties:
        status:
          type: string
          enum:
            - failed
        error:
          type: object
          required:
            - code
            - message
          properties:
            code:
              type: string
            message:
              type: string
    Source:
      type: object
      description: >-
        A sanitized public source. Profile-level sources, section sources, item
        sources, and image sources share this shape.
      required:
        - link
      additionalProperties: true
      properties:
        link:
          type: string
          format: uri
        title:
          type: string
        summary:
          type: string
        caption:
          type: string
        images:
          type: array
          items:
            type: string
            format: uri
        sourceName:
          type: string
        sourceImage:
          type: string
          format: uri
        chunks:
          type: array
          description: Public evidence text extracted from the source.
          items:
            type: object
            required:
              - text
            properties:
              text:
                type: string
        sources:
          type: array
          description: >-
            Nested public sources when one source record contains additional
            sources.
          items:
            $ref: '#/components/schemas/Source'
  responses:
    BadRequest:
      description: The request is not valid.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    Unauthorized:
      description: The API key is missing or not valid.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    Forbidden:
      description: The API key does not have the required scope.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    NotFound:
      description: The requested resource was not found.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    RateLimited:
      description: The API key exceeded a rate limit.
      headers:
        Retry-After:
          description: Seconds to wait before another request.
          schema:
            type: integer
            minimum: 0
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: Orbit API key
      description: Use an Orbit API key from the developer dashboard.

````