# List all certificates.

**GET /api/v1/files/certificates**

Returns a list of certificates. The certificates are returned sorted by creation date, with the most recently created certificates appearing first. Supports pagination using `starting_after` and `ending_before`.

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

## Parameters

### Query parameters

- **limit** (integer)  
  A limit on the number of objects to be returned. The limit can range between `1` and `100`, and the default is `10`.

- **starting_after** (string)  
  A cursor for use in pagination. `starting_after` is a certificate ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `ca_123`, your subsequent call can include `starting_after=ca_123` in order to fetch the next page of the list.

- **ending_before** (string)  
  A cursor for use in pagination. `ending_before` is a certificate ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `ca_456`, your subsequent call can include `ending_before=ca_456` in order to fetch the previous page of the list.

- **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 an array of certificate objects. If no more certificates are available, the resulting array will be empty.

#### Body: application/json (array[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.