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

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

# Get Policy Status

`GET` `/policy/status`

Operation ID: `getPolicyStatus`

Retrieves policy details including status, key identifiers, and metadata for a given policy key. Returns a list of policy summaries from the outbound-services-call API.

## Query parameters

- `policyKey` (string, required) - Policy key (mandatory)

## 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` - Policy status retrieved successfully
- `400` - Bad request - PolicyKey is mandatory
- `404` - Policy not found for the given policyKey
- `500` - Internal server error

## 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/status:
    get:
      security:
        - api_key: []
      tags:
        - Policy
      summary: Get Policy Status
      description: Retrieves policy details including status, key identifiers, and
        metadata for a given policy key. Returns a list of policy summaries from
        the outbound-services-call API.
      operationId: getPolicyStatus
      parameters:
        - $ref: "#/components/parameters/XOriginationSource"
        - $ref: "#/components/parameters/XAuditUserId"
        - name: policyKey
          in: query
          description: Policy key (mandatory)
          required: true
          schema:
            type: string
          example: "22170"
      responses:
        "200":
          description: Policy status retrieved successfully
          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/PolicyStatusSummary"
              examples:
                Policy Retrieved:
                  summary: Example of policy status retrieved successfully
                  description: Policy Retrieved
                  value:
                    policykey: 1086334
                    policyactivitykey: 1141169
                    account: 4040940
                    insured: 4040940
                    producer: 2000556
                    product: 4
                    effectiveDate: 2026-01-15
                    expiryDate: 2027-01-15
                    id: 0
                    policyStatus: Submission
                    policyActivityStatus: Submission to Clear
        "400":
          description: Bad request - PolicyKey is mandatory
          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:
                Missing Policy Key:
                  summary: Error when policyKey is not provided
                  description: Missing Policy Key
                  value:
                    error:
                      code: VALIDATION_ERROR
                      message: PolicyKey is mandatory
        "404":
          description: Policy not found for the given policyKey
          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: Error when no policy matches the given policyKey
                  description: Policy Not Found
                  value:
                    error:
                      code: NOT_FOUND
                      message: "No policy found for policyKey: 99999"
        "500":
          description: Internal server error
          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:
                Internal Server Error:
                  summary: Unexpected error during policy retrieval
                  description: Internal Server Error
                  value:
                    error:
                      code: INTERNAL_ERROR
                      message: "Error retrieving policy: service unavailable"
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:
    PolicyStatusSummary:
      type: object
      description: Summary of a policy returned by the /policies/status endpoint.
      properties:
        policykey:
          type: integer
          description: Internal policy key identifier
          example: 1086334
        policyactivitykey:
          type: integer
          description: Internal policy key identifier
          example: 1141169
        account:
          type: integer
          description: Account contact key
          example: 4040940
        insured:
          type: integer
          description: Insured contact key
          example: 4040940
        producer:
          type: integer
          description: Producer contact key
          example: 2000556
        product:
          type: integer
          description: Product identifier
          example: 4
        effectiveDate:
          type: string
          format: date
          description: Policy effective date
          example: 2026-01-15
        expiryDate:
          type: string
          format: date
          description: Policy expiry date
          example: 2027-01-15
        id:
          type: integer
          description: Identifier
          example: 0
        policyStatus:
          type: string
          description: Current status of the policy
          example: Bound
          enum:
            - Quote Preparation
            - Quote
            - Bound
            - Submission Declined
            - Quote NTU
        policyActivityStatus:
          type: string
          description: Status of the policy
          example: Bound
          enum:
            - Active
            - Bound
            - Completed
            - Pending
            - Cancelled
            - Quote NTU
    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
```