List access contracts · Recuut Docs

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.

GET/merchant/v1/contracts

Request

Query Parameters

include_integration_key?

Include cross-environment Resource and revision correlation keys. Generated SDKs request this metadata explicitly.

Authentication

Authorization*Bearer <token>

Private API key for your Recuut account. A recuut_test_ key uses test payers and transactions. A recuut_live_ key uses live data. Send this key only from your server.

In: header

Response

application/json

Schema

OpenAPI document containing active resource reporting rules.

components*ContractComponentsSchema

Contract schemas and security scheme.

schemas*Schemas

Active contract revisions keyed by their exact x-recuut-revision-id value.

[key: string]?ContractRevisionSchema

Fixed reporting rules for one published resource version.

securitySchemes*Securityschemes

Authentication schemes for contracts.

[key: string]?MerchantApiSecuritySchemeSchema

Bearer API-key scheme used by generated contract documents.

info*ContractInfoSchema

Contract document metadata.

openapi*

OpenAPI document version.

paths*Paths

Reserved path map; contract discovery exposes schemas only.

security*Security

Authentication required to use protected resources.

Request example

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

HTTP response examples

200 · OKapplication/json

One published revision keyed by the same revision ID used in the completion example.

{  "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": []    }  ]}