--- updatedAt: 2026-09-04T18:00:32.000Z agentTools: projectIndex: https://developers.tackle.io/llms.txt --- # Get a cancellation request Returns a single cancellation request by ID. List and get return the same fields, including `description` and `statusMessage` when present. # OpenAPI definition ```json { "openapi": "3.0.3", "info": { "title": "AWS Contracts", "description": "Read invoices and manage billing actions for your AWS Marketplace agreements.\n\nUse agreement-scoped endpoints to list invoices, request billing adjustments\n(refunds), request or track agreement cancellations, and submit flexible payment\nschedule charges.\n\n## Authentication\n\nSend a machine-to-machine (MTM) bearer token on every request. Exchange your\nclient ID and secret at `POST /mtm/v1/authenticate` on the Tackle platform API,\nthen send `Authorization: Bearer `.\n\nThe token scopes every request to your Tackle account.\n\n## Conventions\n\n- List endpoints return `{ \"\": [...], \"next\": \"\" }`. Page with\n `cursor` and `limit`. `next` is absent on the last page. An empty collection is a\n `200` with an empty array, not a `404`.\n- Cursors are opaque. Do not parse, construct, or persist them beyond the walk of a\n single list.\n- A sub-resource list returns `404` when the parent agreement does not exist for your\n account.\n- `null` and empty-string attributes are omitted from responses rather than sent.\n- Status and reason-code values come from AWS Marketplace. New values may appear\n without a version change, so treat these enums as open and handle unknown values\n gracefully.\n", "version": "1.0.0", "contact": { "name": "Tackle Engineering", "url": "https://developers.tackle.io" } }, "servers": [ { "url": "https://aws-agreement-api.tackle.io", "description": "Production" }, { "url": "https://aws-agreement-api.dev.tkl.sh", "description": "Development" } ], "security": [ { "tackleAuth": [] } ], "tags": [ { "name": "Cancellations", "description": "Agreement cancellation requests" } ], "paths": { "/api/agreements/{agreementId}/cancellations/{cancellationRequestId}": { "get": { "tags": [ "Cancellations" ], "summary": "Get a cancellation request", "description": "Returns a single cancellation request by ID. List and get return the same\nfields, including `description` and `statusMessage` when present.\n", "operationId": "getCancellation", "parameters": [ { "$ref": "#/components/parameters/agreementId" }, { "$ref": "#/components/parameters/cancellationRequestId" } ], "responses": { "200": { "description": "The cancellation request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Cancellation" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "500": { "$ref": "#/components/responses/InternalServerError" } } } } }, "components": { "securitySchemes": { "tackleAuth": { "type": "http", "scheme": "bearer", "description": "Machine-to-machine bearer token from the Tackle client-credentials flow.\nExchange your client ID and secret at `POST /mtm/v1/authenticate` on the\nTackle platform API and send the returned token as\n`Authorization: Bearer `.\n" } }, "parameters": { "agreementId": { "name": "agreementId", "in": "path", "required": true, "description": "Agreement identifier", "schema": { "type": "string", "maxLength": 64, "pattern": "^[A-Za-z0-9_/-]+$", "example": "agmt-108thhmmjuh4xup41tmxqu23e" } }, "cancellationRequestId": { "name": "cancellationRequestId", "in": "path", "required": true, "description": "Cancellation request identifier", "schema": { "type": "string", "example": "acr-0a1b2c3d4e5f" } } }, "schemas": { "CancellationStatus": { "type": "string", "description": "Current state of the cancellation request.\n\n| Value | Meaning |\n|---|---|\n| `PENDING_APPROVAL` | Awaiting buyer action. Auto-approved after 7 days with no response. |\n| `APPROVED` | Approved by the buyer or by auto-approval after 7 days. |\n| `REJECTED` | Declined by the buyer. |\n| `CANCELLED` | Withdrawn by you before approval. |\n| `VALIDATION_FAILED` | Rejected. See `statusMessage` for details. |\n\nThere is no `EXPIRED` status. An unanswered request is auto-approved, not expired.\n", "enum": [ "PENDING_APPROVAL", "APPROVED", "REJECTED", "CANCELLED", "VALIDATION_FAILED" ] }, "CancellationReasonCode": { "type": "string", "description": "Why you are requesting the cancellation. Not interchangeable with billing\nadjustment reason codes.\n", "enum": [ "ALTERNATIVE_PROCUREMENT_CHANNEL", "BUYER_DISSATISFACTION", "INCORRECT_TERMS_ACCEPTED", "OTHER", "PRODUCT_DISCONTINUED", "REPLACING_AGREEMENT", "TEST_AGREEMENT", "UNINTENDED_RENEWAL" ] }, "Cancellation": { "type": "object", "required": [ "id", "vendorId", "agreementId", "status", "reasonCode", "created", "lastModified" ], "properties": { "id": { "type": "string", "example": "acr-0a1b2c3d4e5f" }, "vendorId": { "type": "string", "example": "MPSELLERTESTVENDOR" }, "agreementId": { "type": "string", "example": "agmt-108thhmmjuh4xup41tmxqu23e" }, "status": { "$ref": "#/components/schemas/CancellationStatus" }, "reasonCode": { "$ref": "#/components/schemas/CancellationReasonCode" }, "description": { "type": "string", "description": "Free-text detail you supplied when creating the request. Omitted when empty.\n", "maxLength": 2000 }, "statusMessage": { "type": "string", "description": "Details about the current status. Omitted when empty.\n" }, "created": { "type": "string", "format": "date-time", "description": "When the request was created. The 7-day auto-approval window starts here. No\nexplicit deadline is returned on the resource.\n" }, "lastModified": { "type": "string", "format": "date-time" } } }, "Error": { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "string", "description": "Human-readable explanation of the failure", "example": "Missing required parameters" } } } }, "responses": { "BadRequest": { "description": "The request is malformed or missing required parameters.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "Missing required parameters" } } } }, "Unauthorized": { "description": "The bearer token is missing, malformed, or expired", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "Unauthorized" } } } }, "Forbidden": { "description": "The token is valid but is not permitted to perform this action.\n", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "Forbidden" } } } }, "NotFound": { "description": "The requested resource does not exist for your account", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "Not found" } } } }, "InternalServerError": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "Internal server error" } } } } } } } ```