---
title: "List agreements"
method: GET
path: "/agreements"
tags: ["Agreements"]
---

# List agreements

`GET /agreements`

## Request

- Base URL: `https://dataroom.corgi.com/api/v1`
- URL: `https://dataroom.corgi.com/api/v1/agreements`
- Auth: HTTP bearer

Agreements you've sent out (signature requests); templates and gate acceptances are excluded. Scope: `envelopes:read`.

## Query parameters

- `status` 'DRAFT' | 'SENT' | 'VIEWED' | 'PARTIAL' | 'COMPLETED' | 'DECLINED' | 'VOIDED' | 'EXPIRED'
- `cursor` string
- `take` integer

## Response `200`

A page of agreements

## Other responses

- `401`: Unauthenticated
- `403`: Insufficient scope

---

[API](https://skmtc.dev/corgi/apis/dataroom-api.md) - [All operations](https://skmtc.dev/corgi/apis/dataroom-api/llms.txt) - [OpenAPI document](https://skmtc.dev/corgi/apis/dataroom-api/revisions/73f75ef04a00?raw)