# 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.


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