# Create a certificate status

Creates a new status for a certificate request. Returns the generated
StatusId, which you use to update the status or upload a document.

Endpoint: POST /c/service-provider/{providerId}/actuary/certificate-request/{requestId}/status
Version: 1.0
Security: Class_oAuth

## Path parameters:

  - `providerId` (string, required)
    The unique Provider ID assigned to your organisation during registration.

  - `requestId` (string, required)
    The unique identifier for the certificate request. From SourceRef in the initial request payload Class sent to your endpoint.

## Request fields (application/json):

  - `BusinessCode` (string, required)
    Identifies the Class business. From Client.SourceRef in the initial request.
    Example: demo-business

  - `FundCode` (string, required)
    Identifies the Class fund. From Fund.SourceRef in the initial request.
    Example: demo-fund

  - `RequestId` (string, required)
    The certificate request identifier. From SourceRef in the initial request.
    Example: bb978063-2bed-449f-932d-79a1557c3c09

  - `Status` (string)
    The status label for this update. Defaults to Interim if omitted.
    Enum: "Interim", "Final"

  - `ExemptPercentage` (string, required)
    The exempt current pension income percentage. A % sign and spaces are trimmed, then the value is parsed to a decimal. Percentages are decimal values, not whole numbers. An empty or unparseable value results in a 400 response.
    Example: 63.18

  - `UseDeemedSegregation` (boolean)
    Optional provider-supplied flag. Stored and echoed back as supplied.
    Example: true

## Response 200 fields (application/json):

  - `Data` (object)
    The status as stored by Class.

  - `Data.StatusId` (string)
    The unique identifier for this status. Use it for update and document upload.
    Example: a9e9cfce-e3b5-4077-b824-77d23a109ae3

  - `Data.ActuarialPercentage` (number)
    The parsed exempt percentage stored against the status.
    Example: 63.18

  - `Data.StatusDateTime` (string)
    Example: 2026-07-29T09:51:48

  - `Data.Description` (string)
    A system-generated description, including the percentage and status label.
    Example: Response received; Actuarial Percentage: 63.18% (Interim)

  - `Data.StatusMessage` (string)

  - `Data.UseDeemedSegregation` (boolean)
    Example: true

  - `Errors` (array)

  - `Errors.Code` (string)
    Example: API_INTERNAL_ERROR

  - `Errors.Message` (string)
    Example: An unexpected error occurred.

## Response 400 fields (application/json):

  - `Errors` (array)

  - `Errors.Code` (string)
    Example: API_INTERNAL_ERROR

  - `Errors.Message` (string)
    Example: An unexpected error occurred.

## Response 401 fields (application/json):

  - `Errors` (array)

  - `Errors.Code` (string)
    Example: API_INTERNAL_ERROR

  - `Errors.Message` (string)
    Example: An unexpected error occurred.

## Response 403 fields (application/json):

  - `Errors` (array)

  - `Errors.Code` (string)
    Example: API_INTERNAL_ERROR

  - `Errors.Message` (string)
    Example: An unexpected error occurred.

## Response 404 fields (application/json):

  - `Errors` (array)

  - `Errors.Code` (string)
    Example: API_INTERNAL_ERROR

  - `Errors.Message` (string)
    Example: An unexpected error occurred.

## Response 500 fields (application/json):

  - `Errors` (array)

  - `Errors.Code` (string)
    Example: API_INTERNAL_ERROR

  - `Errors.Message` (string)
    Example: An unexpected error occurred.