# Retrieve a certificate.

**GET /api/v1/files/certificates/{certificate}**


Retrieves the details of an existing certificate by its ID. Use this endpoint
to poll for certificate status updates during asynchronous processing.

**Certificate Status Lifecycle:**

The certificate status transitions through the following states:
- `pending` - Certificate has been uploaded but processing has not started
- `processing` - Certificate is currently being processed
- `approved` - Certificate passed all insurance requirements
- `flagged` - Certificate failed some requirements (may require manual review)
- `denied` - Certificate was denied
- `error` - An error occurred during processing

**Retrieving Review Results:**

Once processing is complete, use the `expand` parameter to retrieve review results:
- `expand[]=review_results` - Returns abbreviated results with summary counts
- `expand[]=review_results.full` - Returns full parsed certificate data and detailed
  audit results for each insurance requirement




## Servers
- Production server: https://api.1099policy.com (Production server)



## Parameters

#### Path parameters
- **certificate** (string)
  The ID of the desired certificate.

#### Query parameters
- **expand** (array[string])
  Specifies which fields in the response should be expanded. Use `expand[]=review_results` for abbreviated review results, or `expand[]=review_results.full` for full review results including parsed certificate data and detailed audit results.



## Responses
### 200: Returns a certificate object if a valid certificate ID was provided. The `status` field indicates the current processing state, and `review_results` will be `null` until processing completes.


#### Body Parameters: application/json (object)
- **contractor** (string)
  The ID of the contractor associated with this certificate.
- **created** (integer(int64))
  Time at which the certificate was uploaded.
- **filename** (string)
  The original filename of the uploaded PDF.
- **id** (string)
  Unique identifier for the certificate.
- **pdf_url** (string | null)
  URL to access the certificate PDF. This will be `null` until the certificate has been processed and stored.
- **review_results** (object | null)
  Review results from the certificate evaluation. This will be `null` until processing completes. Use `expand[]=review_results` to include abbreviated results, or `expand[]=review_results.full` for complete details.
- **status** (string)
  The current processing status of the certificate. Status transitions: `pending` → `processing` → (`approved` | `flagged` | `denied` | `error`). Use polling or webhooks to monitor status changes.
- **updated** (integer(int64))
  Time at which the certificate was last updated.

### 404: Certificate not found


[Powered by Bump.sh](https://bump.sh)