---
title: "Check Step Status - Policy"
url: "https://apipartners.mosaicinsurance.com/apis/trident-sandbox-1/versions/063565b3-7d5d-4ebb-9e4e-ea5966a41579/operations/getOrchestrationStatus"
---

> Full API specification: https://apipartners.mosaicinsurance.com/apis/trident-sandbox-1/versions/063565b3-7d5d-4ebb-9e4e-ea5966a41579.md

# Check Step Status - Policy

`GET` `/policy/global/{policyNo}/status`

Operation ID: `getOrchestrationStatus`

Returns the per-step status (base / full / quote / bind) plus the attempt counters and last error messages for a submission. Updated by a background reconciler as the asynchronous steps complete.

## Path parameters

- `policyNo` (string, required) - Policy number returned by POST /policies/orchestrate

## Header parameters

- `X-Origination-Source` (string, required) - Identifies the calling system or channel that originated this request. Used for traceability and auditing across the platform.
- `X-Audit-UserId` (string, required) - Identifier of the end user on whose behalf this request is made, recorded for audit trail purposes.

## Responses

- `200` - Status row found.
- `404` - No submission found for the given policy number.

## OpenAPI definition

```yaml
openapi: 3.0.1
info:
  title: Trident APIs
  version: dev
servers:
  - url: https://apinonprod.mosaicinsurance.com
    description: Generated server url
paths:
  /policy/global/{policyNo}/status:
    get:
      security:
        - api_key: []
      tags:
        - Admin/Develop
      summary: Check Step Status - Policy
      description: Returns the per-step status (base / full / quote / bind) plus the
        attempt counters and last error messages for a submission. Updated by a
        background reconciler as the asynchronous steps complete.
      operationId: getOrchestrationStatus
      parameters:
        - $ref: "#/components/parameters/XOriginationSource"
        - $ref: "#/components/parameters/XAuditUserId"
        - name: policyNo
          in: path
          required: true
          description: Policy number returned by POST /policies/orchestrate
          schema:
            type: string
          example: Q0038456
      responses:
        "200":
          description: Status row found.
          headers:
            Access-Control-Allow-Origin:
              schema:
                type: string
            Access-Control-Allow-Methods:
              schema:
                type: string
            Access-Control-Allow-Headers:
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/SubmissionStatus"
              examples:
                Base Step Completed:
                  summary: Status after base step completed
                  description: Base Step Completed
                  value:
                    submissionId: 9b3f7c1c-1f0a-4e2d-9d7c-2e3a8b4c6d2e
                    policyNo: Q0038456
                    overallStatus: BASE_OK
                    currentStep: FULL
                    executionArn: arn:aws:states:us-east-2:123456789012:execution:TridentGlobalSubmission:fresh-9b3f7c1c-...
                    policyKey: "20894"
                    policyActivityKey: "45632"
                    baseStatus: SUCCESS
                    baseAttempts: 1
                    baseError: null
                    fullStatus: PENDING
                    fullAttempts: 0
                    fullError: null
                    quoteStatus: PENDING
                    quoteAttempts: 0
                    quoteError: null
                    bindStatus: PENDING
                    bindAttempts: 0
                    bindError: null
                    createdAt: 2026-05-04T12:34:56.789
                    updatedAt: 2026-05-04T12:35:01.123
        "404":
          description: No submission found for the given policy number.
          headers:
            Access-Control-Allow-Origin:
              schema:
                type: string
            Access-Control-Allow-Methods:
              schema:
                type: string
            Access-Control-Allow-Headers:
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
              examples:
                Policy Not Found:
                  summary: Unknown policyNo
                  description: Policy Not Found
                  value:
                    error:
                      code: NOT_FOUND
                      message: No submission found for policyNo=Q0038456
security:
  - api_key: []
components:
  parameters:
    XOriginationSource:
      name: X-Origination-Source
      in: header
      required: true
      description: Identifies the calling system or channel that originated this
        request. Used for traceability and auditing across the platform.
      schema:
        type: string
      example: S01x
    XAuditUserId:
      name: X-Audit-UserId
      in: header
      required: true
      description: Identifier of the end user on whose behalf this request is made,
        recorded for audit trail purposes.
      schema:
        type: string
      example: jsmith
  schemas:
    SubmissionStatus:
      type: object
      description: Persisted per-step status for a global submission.
      properties:
        submissionId:
          type: string
          format: uuid
          example: 9b3f7c1c-1f0a-4e2d-9d7c-2e3a8b4c6d2e
        policyNo:
          type: string
          example: Q0038456
        overallStatus:
          type: string
          enum:
            - PENDING
            - RUNNING
            - BASE_OK
            - FULL_OK
            - QUOTE_OK
            - SUCCESS
            - FAILED
          example: BASE_OK
        currentStep:
          type: string
          enum:
            - BASE
            - FULL
            - QUOTE
            - BIND
            - DONE
          example: FULL
        executionArn:
          type: string
          example: arn:aws:states:us-east-2:123456789012:execution:TridentGlobalSubmission:fresh-9b3f7c1c-...
        policyKey:
          type: string
          example: "20894"
        policyActivityKey:
          type: string
          example: "45632"
        baseStatus:
          type: string
          enum:
            - PENDING
            - SUCCESS
            - FAILED
          example: SUCCESS
        baseAttempts:
          type: integer
          example: 1
        baseError:
          type: string
          nullable: true
        baseOutputJson:
          type: string
          description: Raw JSON output of the base step (audit)
          nullable: true
        fullStatus:
          type: string
          enum:
            - PENDING
            - SUCCESS
            - FAILED
          example: PENDING
        fullAttempts:
          type: integer
          example: 0
        fullError:
          type: string
          nullable: true
        fullOutputJson:
          type: string
          nullable: true
        quoteStatus:
          type: string
          enum:
            - PENDING
            - SUCCESS
            - FAILED
          example: PENDING
        quoteAttempts:
          type: integer
          example: 0
        quoteError:
          type: string
          nullable: true
        quoteOutputJson:
          type: string
          nullable: true
        bindStatus:
          type: string
          enum:
            - PENDING
            - SUCCESS
            - FAILED
          example: PENDING
        bindAttempts:
          type: integer
          example: 0
        bindError:
          type: string
          nullable: true
        bindOutputJson:
          type: string
          nullable: true
        createdAt:
          type: string
          format: date-time
          example: 2026-05-04T12:34:56.789Z
        updatedAt:
          type: string
          format: date-time
          example: 2026-05-04T12:35:01.123Z
    ErrorResponse:
      type: object
      properties:
        error:
          $ref: "#/components/schemas/ErrorDetail"
    ErrorDetail:
      type: object
      properties:
        code:
          type: string
        message:
          type: string
  securitySchemes:
    api_key:
      type: apiKey
      name: x-api-key
      in: header
```