Developers
Legal terms

List a user's legal term acceptances

GET/users/{user_id}/term-acceptances

Lists a user's acceptances across the platform legal term and all product legal terms, using cursor-based pagination. The collection can be filtered by acceptance date.

Each item includes links.self, which points to the acceptance under its legal term. Use that URL with the retrieve acceptance operation.

The proof object is included only when the credentials have the legal_terms.read_proof permission.

Authorization

AuthorizationBearer <token>

Autonomous mode: the API credential secret, sent as a bearer token. Credential secrets are identified by a fixed prefix.

In: header

Path Parameters

user_id*string

Query Parameters

limit?integer
Range1 <= value <= 200
cursor?string
sort?string

Value in

  • "id"
  • "-id"
accepted_after?string
Formatdate-time
accepted_before?string
Formatdate-time

Header Parameters

X-Client-Request-Id?string

Optional client-generated identifier of the request, up to 64 characters from [A-Za-z0-9._-]. Echoed back in the response and recorded in the request log; it never replaces the server-generated X-Request-Id.

Lengthlength <= 64

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/users/string/term-acceptances"
{  "data": [    {      "accepted_at": "2019-08-24T14:15:22Z",      "id": "string",      "legal_term_id": "string",      "links": {        "self": "string"      },      "object": "term_acceptance",      "proof": {        "ip": "string",        "user_agent": "string"      },      "user_id": "string"    }  ],  "page": {    "limit": 1,    "next_cursor": "string",    "prev_cursor": "string"  }}

Retrieve a legal term acceptance GET

Retrieves an acceptance of a legal term by its public ID. This is the canonical location of every acceptance, including those returned in a user's acceptance history. The `proof` object, containing the IP address and user agent recorded at acceptance, is included only when the credentials have the `legal_terms.read_proof` permission. Otherwise, it is omitted from the response.

Account

Next Page