---
title: "Retrieve Agreement"
method: GET
path: "/tenants/{tenant_id}/agreements/{id}"
tags: ["Agreements"]
---

# Retrieve Agreement

`GET /tenants/{tenant_id}/agreements/{id}`

Retrieve an agreement by ID. Returns either an agreement backed by Docusign or Dropbox Sign. The `signing_provider` field in the response indicates which provider the agreement is backed by.

## Path parameters

- `tenant_id` string, uuid, required
- `id` string, uuid, required

## Response `200`

Agreement successfully retrieved.

- object
  - `agreement` object
    - `id` string, uuid — A unique ID identifying the agreement.
    - `project_id` string, uuid — A unique ID identifying the project that the agreement belongs to.
    - `design_id` string, uuid — A unique ID identifying the design that the agreement belongs to.
    - `agreement_template_name` string — The name of the template used to generate the agreement.
    - `status` 'cancel_pending' | 'canceled' | 'sent' | 'viewed' | 'signed' | 'error' | 'declined' — The status of the agreement.
    - `last_viewed_at` string, nullable — The timestamp of when the agreement was last viewed, formatted as "YYYY-MM-DD HH:MM:SS UTC". Null for Docusign agreements.
    - `created_at` string — The timestamp of when the agreement was created, formatted as "YYYY-MM-DD HH:MM:SS UTC"
    - `sent_at` string, nullable — The timestamp of when the agreement was sent, formatted as "YYYY-MM-DD HH:MM:SS UTC". Null for Docusign agreements.
    - `error_message` string, nullable — A description of the caught error. Null for Docusign agreements.
    - `signing_provider` 'dropbox_sign' | 'docusign' — The e-signature provider that backs this agreement.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found

---

[API](https://skmtc.net/aurorasolar/apis/sync-api.md) · [All operations](https://skmtc.net/aurorasolar/apis/sync-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aurorasolar/sync-api/revisions/5b41808d104d/schema)