# GET `/merchant/v1/contracts`

[Documentation page](/api-reference/contracts/resources.contracts.list)

## Summary

List access contracts

## Description

Returns each published revision, its settlement asset, and the usage values your app must report, in OpenAPI format. SDKs and tools use this response. The API key selects one environment; equivalent Resources may share the published integration key across environments.

## Security requirements

```json
[
  {
    "OrganizationApiKeyAuth": []
  }
]
```

## Operation parameters

### query `include_integration_key`

```json
{
  "description": "Include cross-environment Resource and revision correlation keys. Generated SDKs request this metadata explicitly.",
  "in": "query",
  "name": "include_integration_key",
  "required": false,
  "schema": {
    "default": false,
    "description": "Include cross-environment Resource and revision correlation keys. Generated SDKs request this metadata explicitly.",
    "title": "Include Integration Key",
    "type": "boolean"
  }
}
```

## Responses

### 200

```json
{
  "content": {
    "application/json": {
      "examples": {
        "published_contracts": {
          "description": "One published revision keyed by the same revision ID used in the completion example.",
          "summary": "Published contracts",
          "value": {
            "components": {
              "schemas": {
                "acr_00000000000070008000000000000000": {
                  "additionalProperties": false,
                  "properties": {
                    "input_tokens": {
                      "description": "Number of input tokens consumed by the report.",
                      "format": "decimal",
                      "pattern": "^(?:0|[1-9][0-9]{0,17})(?:\\.[0-9]{1,12})?$",
                      "type": "string",
                      "x-recuut-decimal-places": 12,
                      "x-recuut-label": "Input tokens",
                      "x-recuut-max-digits": 30,
                      "x-recuut-position": 0,
                      "x-recuut-unit": "token"
                    }
                  },
                  "required": [
                    "input_tokens"
                  ],
                  "title": "Quarterly report usage",
                  "type": "object",
                  "x-recuut-resource-description": "Generate a paid quarterly research report.",
                  "x-recuut-resource-id": "res_00000000000070008000000000000000",
                  "x-recuut-resource-integration-key": "quarterly_report",
                  "x-recuut-resource-name": "Quarterly report",
                  "x-recuut-revision-id": "acr_00000000000070008000000000000000",
                  "x-recuut-revision-key": "rvk_00000000000070008000000000000000",
                  "x-recuut-revision-name": "Usage v1",
                  "x-recuut-revision-number": 1,
                  "x-recuut-settlement-asset": "USDC"
                }
              },
              "securitySchemes": {
                "merchantApiKey": {
                  "scheme": "bearer",
                  "type": "http"
                }
              }
            },
            "info": {
              "title": "Recuut resource contracts",
              "version": "1"
            },
            "openapi": "3.1.0",
            "paths": {},
            "security": [
              {
                "merchantApiKey": []
              }
            ]
          }
        }
      },
      "schema": {
        "$ref": "#/components/schemas/ContractsDocumentSchema"
      }
    }
  },
  "description": "OK"
}
```

### 401

```json
{
  "content": {
    "application/json": {
      "examples": {
        "unauthenticated": {
          "summary": "API key required",
          "value": {
            "code": "unauthenticated",
            "message": "A valid Recuut API key is required."
          }
        }
      },
      "schema": {
        "additionalProperties": false,
        "description": "Error returned for this endpoint and HTTP status.",
        "properties": {
          "code": {
            "const": "unauthenticated",
            "description": "Stable error code your app can check.",
            "type": "string"
          },
          "message": {
            "description": "Short explanation of what went wrong.",
            "type": "string"
          }
        },
        "required": [
          "code",
          "message"
        ],
        "type": "object"
      }
    }
  },
  "description": "Unauthorized"
}
```

### 403

```json
{
  "content": {
    "application/json": {
      "examples": {
        "forbidden": {
          "summary": "Capability denied",
          "value": {
            "code": "forbidden",
            "message": "This API key does not allow this operation."
          }
        }
      },
      "schema": {
        "additionalProperties": false,
        "description": "Error returned for this endpoint and HTTP status.",
        "properties": {
          "code": {
            "const": "forbidden",
            "description": "Stable error code your app can check.",
            "type": "string"
          },
          "message": {
            "description": "Short explanation of what went wrong.",
            "type": "string"
          }
        },
        "required": [
          "code",
          "message"
        ],
        "type": "object"
      }
    }
  },
  "description": "Forbidden"
}
```

## First-party examples

### cURL

```json
{
  "label": "cURL",
  "lang": "shell",
  "source": "curl --request GET \\\n  --url \"$RECUUT_API_URL/merchant/v1/contracts\" \\\n  --header \"Authorization: Bearer $RECUUT_API_KEY\"\n"
}
```

```shell
curl --request GET \
  --url "$RECUUT_API_URL/merchant/v1/contracts" \
  --header "Authorization: Bearer $RECUUT_API_KEY"

```

## Canonical operation

```json
{
  "description": "Returns each published revision, its settlement asset, and the usage values your app must report, in OpenAPI format. SDKs and tools use this response. The API key selects one environment; equivalent Resources may share the published integration key across environments.",
  "operationId": "resources.contracts.list",
  "parameters": [
    {
      "description": "Include cross-environment Resource and revision correlation keys. Generated SDKs request this metadata explicitly.",
      "in": "query",
      "name": "include_integration_key",
      "required": false,
      "schema": {
        "default": false,
        "description": "Include cross-environment Resource and revision correlation keys. Generated SDKs request this metadata explicitly.",
        "title": "Include Integration Key",
        "type": "boolean"
      }
    }
  ],
  "responses": {
    "200": {
      "content": {
        "application/json": {
          "examples": {
            "published_contracts": {
              "description": "One published revision keyed by the same revision ID used in the completion example.",
              "summary": "Published contracts",
              "value": {
                "components": {
                  "schemas": {
                    "acr_00000000000070008000000000000000": {
                      "additionalProperties": false,
                      "properties": {
                        "input_tokens": {
                          "description": "Number of input tokens consumed by the report.",
                          "format": "decimal",
                          "pattern": "^(?:0|[1-9][0-9]{0,17})(?:\\.[0-9]{1,12})?$",
                          "type": "string",
                          "x-recuut-decimal-places": 12,
                          "x-recuut-label": "Input tokens",
                          "x-recuut-max-digits": 30,
                          "x-recuut-position": 0,
                          "x-recuut-unit": "token"
                        }
                      },
                      "required": [
                        "input_tokens"
                      ],
                      "title": "Quarterly report usage",
                      "type": "object",
                      "x-recuut-resource-description": "Generate a paid quarterly research report.",
                      "x-recuut-resource-id": "res_00000000000070008000000000000000",
                      "x-recuut-resource-integration-key": "quarterly_report",
                      "x-recuut-resource-name": "Quarterly report",
                      "x-recuut-revision-id": "acr_00000000000070008000000000000000",
                      "x-recuut-revision-key": "rvk_00000000000070008000000000000000",
                      "x-recuut-revision-name": "Usage v1",
                      "x-recuut-revision-number": 1,
                      "x-recuut-settlement-asset": "USDC"
                    }
                  },
                  "securitySchemes": {
                    "merchantApiKey": {
                      "scheme": "bearer",
                      "type": "http"
                    }
                  }
                },
                "info": {
                  "title": "Recuut resource contracts",
                  "version": "1"
                },
                "openapi": "3.1.0",
                "paths": {},
                "security": [
                  {
                    "merchantApiKey": []
                  }
                ]
              }
            }
          },
          "schema": {
            "$ref": "#/components/schemas/ContractsDocumentSchema"
          }
        }
      },
      "description": "OK"
    },
    "401": {
      "content": {
        "application/json": {
          "examples": {
            "unauthenticated": {
              "summary": "API key required",
              "value": {
                "code": "unauthenticated",
                "message": "A valid Recuut API key is required."
              }
            }
          },
          "schema": {
            "additionalProperties": false,
            "description": "Error returned for this endpoint and HTTP status.",
            "properties": {
              "code": {
                "const": "unauthenticated",
                "description": "Stable error code your app can check.",
                "type": "string"
              },
              "message": {
                "description": "Short explanation of what went wrong.",
                "type": "string"
              }
            },
            "required": [
              "code",
              "message"
            ],
            "type": "object"
          }
        }
      },
      "description": "Unauthorized"
    },
    "403": {
      "content": {
        "application/json": {
          "examples": {
            "forbidden": {
              "summary": "Capability denied",
              "value": {
                "code": "forbidden",
                "message": "This API key does not allow this operation."
              }
            }
          },
          "schema": {
            "additionalProperties": false,
            "description": "Error returned for this endpoint and HTTP status.",
            "properties": {
              "code": {
                "const": "forbidden",
                "description": "Stable error code your app can check.",
                "type": "string"
              },
              "message": {
                "description": "Short explanation of what went wrong.",
                "type": "string"
              }
            },
            "required": [
              "code",
              "message"
            ],
            "type": "object"
          }
        }
      },
      "description": "Forbidden"
    }
  },
  "security": [
    {
      "OrganizationApiKeyAuth": []
    }
  ],
  "summary": "List access contracts",
  "tags": [
    "contracts"
  ],
  "x-codeSamples": [
    {
      "label": "cURL",
      "lang": "shell",
      "source": "curl --request GET \\\n  --url \"$RECUUT_API_URL/merchant/v1/contracts\" \\\n  --header \"Authorization: Bearer $RECUUT_API_KEY\"\n"
    }
  ]
}
```