---
title: "GET /v1/customer-agreement/list"
method: GET
path: "/v1/customer-agreement/list"
---

# GET /v1/customer-agreement/list

`GET /v1/customer-agreement/list`

List active customer-agreements applicable to calling identity.

## Query parameters

- `maxResults` integer
- `nextToken` string

## Response `200`

Success

- ListCustomerAgreementsResponse
  - `customerAgreements` CustomerAgreementSummary[], required — List of customer-agreement resources.
    - `name` string — Name of the customer-agreement resource.
    - `arn` string — ARN of the customer-agreement resource.
    - `id` string — Identifier of the customer-agreement resource.
    - `agreementArn` string — ARN of the agreement resource the customer-agreement resource represents.
    - `awsAccountId` string — AWS account Id that owns the resource.
    - `organizationArn` string — ARN of the organization that owns the resource.
    - `effectiveStart` string, date-time — Timestamp indicating when the agreement became effective.
    - `effectiveEnd` string, date-time — Timestamp indicating when the agreement was terminated.
    - `state` 'ACTIVE' | 'CUSTOMER_TERMINATED' | 'AWS_TERMINATED' — State of the resource.
    - `description` string — Description of the resource.
    - `acceptanceTerms` LongStringAttribute[] — Terms required to accept the agreement resource.
    - `terminateTerms` LongStringAttribute[] — Terms required to terminate the customer-agreement resource.
    - `type` 'CUSTOM' | 'DEFAULT' | 'MODIFIED' — Type of the customer-agreement resource.
  - `nextToken` string — Pagination token to request the next page of resources.

## Other responses

- `480` — ThrottlingException
- `481` — AccessDeniedException
- `482` — InternalServerException
- `483` — ValidationException

---

[API](https://skmtc.net/aws/apis/artifact.md) · [All operations](https://skmtc.net/aws/apis/artifact/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/artifact/versions/7720117618ca/schema)