# Actuarial Certificate

The Actuarial Certificate callback API allows a registered Actuarial
Certificate Provider (ACP) to create and update certificate statuses and
upload the signed certificate document back to Class for a certificate
request initiated by Class.

Use these endpoints after Class has POSTed the initial request to your
system and the Class user has finalised on your website. See the
Provider-to-Class Updates guide for how the endpoints are used together.


<div class="env-panel" data-component-name="EnvPanel"><div class="env-panel__header">Servers</div><div class="env-panel__body"><div class="env-row"><div class="env-name">Partner Integration Environment (Sandbox)</div><div class="env-url-row"><span class="env-url">https://apigateway.class-pie.com.au/api/1.0</span><button type="button" class="copy-btn" data-copy="https://apigateway.class-pie.com.au/api/1.0" aria-label="Copy"><svg viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg" aria-hidden="true"><path fill-rule="evenodd" clip-rule="evenodd" d="M5.16667 2.66667C5.16667 2.57462 5.24129 2.5 5.33333 2.5H12C12.092 2.5 12.1667 2.57462 12.1667 2.66667V10.6667C12.1667 10.7587 12.092 10.8333 12 10.8333H10H5.33333C5.24129 10.8333 5.16667 10.7587 5.16667 10.6667V4.66667V2.66667ZM4.16667 4.16667V2.66667C4.16667 2.02233 4.689 1.5 5.33333 1.5H12C12.6443 1.5 13.1667 2.02233 13.1667 2.66667V10.6667C13.1667 11.311 12.6443 11.8333 12 11.8333H10.5V13.3333C10.5 13.6428 10.3771 13.9395 10.1583 14.1583C9.9395 14.3771 9.64275 14.5 9.33333 14.5H2.66667C2.35725 14.5 2.0605 14.3771 1.84171 14.1583C1.62292 13.9395 1.5 13.6428 1.5 13.3333V5.33333C1.5 5.02391 1.62292 4.72717 1.84171 4.50838C2.0605 4.28958 2.35725 4.16667 2.66667 4.16667H4.16667ZM9.5 11.8333V13.3333C9.5 13.3775 9.48244 13.4199 9.45118 13.4512C9.41993 13.4824 9.37754 13.5 9.33333 13.5H2.66667C2.62246 13.5 2.58007 13.4824 2.54882 13.4512C2.51756 13.4199 2.5 13.3775 2.5 13.3333V5.33333C2.5 5.28913 2.51756 5.24674 2.54882 5.21548C2.58007 5.18423 2.62246 5.16667 2.66667 5.16667H4.16667V10.6667C4.16667 11.311 4.689 11.8333 5.33333 11.8333H9.5Z" fill="currentColor"/></svg></button></div></div><div class="env-row"><div class="env-name">Production Environment</div><div class="env-url-row"><span class="env-url">https://apigateway.class.com.au/api/1.0</span><button type="button" class="copy-btn" data-copy="https://apigateway.class.com.au/api/1.0" aria-label="Copy"><svg viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg" aria-hidden="true"><path fill-rule="evenodd" clip-rule="evenodd" d="M5.16667 2.66667C5.16667 2.57462 5.24129 2.5 5.33333 2.5H12C12.092 2.5 12.1667 2.57462 12.1667 2.66667V10.6667C12.1667 10.7587 12.092 10.8333 12 10.8333H10H5.33333C5.24129 10.8333 5.16667 10.7587 5.16667 10.6667V4.66667V2.66667ZM4.16667 4.16667V2.66667C4.16667 2.02233 4.689 1.5 5.33333 1.5H12C12.6443 1.5 13.1667 2.02233 13.1667 2.66667V10.6667C13.1667 11.311 12.6443 11.8333 12 11.8333H10.5V13.3333C10.5 13.6428 10.3771 13.9395 10.1583 14.1583C9.9395 14.3771 9.64275 14.5 9.33333 14.5H2.66667C2.35725 14.5 2.0605 14.3771 1.84171 14.1583C1.62292 13.9395 1.5 13.6428 1.5 13.3333V5.33333C1.5 5.02391 1.62292 4.72717 1.84171 4.50838C2.0605 4.28958 2.35725 4.16667 2.66667 4.16667H4.16667ZM9.5 11.8333V13.3333C9.5 13.3775 9.48244 13.4199 9.45118 13.4512C9.41993 13.4824 9.37754 13.5 9.33333 13.5H2.66667C2.62246 13.5 2.58007 13.4824 2.54882 13.4512C2.51756 13.4199 2.5 13.3775 2.5 13.3333V5.33333C2.5 5.28913 2.51756 5.24674 2.54882 5.21548C2.58007 5.18423 2.62246 5.16667 2.66667 5.16667H4.16667V10.6667C4.16667 11.311 4.689 11.8333 5.33333 11.8333H9.5Z" fill="currentColor"/></svg></button></div></div></div></div>

Version: 1.0

Metadata:
  - apiId: Actuarial Provider v1

## Servers

Partner Integration Environment (Sandbox)
```
https://apigateway.class-pie.com.au/api/1.0
```

Production Environment
```
https://apigateway.class.com.au/api/1.0
```

## Security

### Class_oAuth

Class uses OAuth 2.0 with Bearer tokens. The Actuarial Certificate
callback API uses the Resource Owner Password Flow. The token endpoint
is on the app host (e.g. https://app.class-pie.com.au/connect/token),
which differs from the apigateway host used for the API calls.
See the Authentication guide.


Type: oauth2
Token URL: https://app.class-pie.com.au/connect/token
Scopes:
- `fund.read`: View fund information

## Download OpenAPI description

 - [Actuarial Certificate](https://nonprod.developer.myhub.com.au/_bundle/products/class/apis/actuarial%20provider/actuarial-certificate.yaml)

 - [POST /c/service-provider/{providerId}/actuary/certificate-request/{requestId}/status](https://nonprod.developer.myhub.com.au/products/class/apis/actuarial-provider/actuarial-certificate/other/createrequeststatus.md): Creates a new status for a certificate request. Returns the generated StatusId, which you use to update the status or upload a document.
 - [POST /c/service-provider/{providerId}/actuary/certificate-request/{requestId}/status/{statusId}](https://nonprod.developer.myhub.com.au/products/class/apis/actuarial-provider/actuarial-certificate/other/updaterequeststatus.md): Updates an existing status. Overwrites the percentage, the UseDeemedSegregation flag, the stored body, and the timestamp on the status identified by statusId.
 - [POST /c/service-provider/{providerId}/actuary/certificate-request/{requestId}/status/{statusId}/doc](https://nonprod.developer.myhub.com.au/products/class/apis/actuarial-provider/actuarial-certificate/other/uploadcertificatedocument.md): Uploads the signed actuarial certificate (PDF) and attaches it to an existing status. The document is sent as the raw request body with Content-Type application/pdf (not multipart/form-data). Only PDF