---
title: "Present the permit once, immediately before posting"
method: POST
path: "/v1/connections/{connectionId}/executions/{executionId}/claims"
---

# Present the permit once, immediately before posting

`POST /v1/connections/{connectionId}/executions/{executionId}/claims`

## Request

- Base URL: `https://api.decionis.com`
- URL: `https://api.decionis.com/v1/connections/{connectionId}/executions/{executionId}/claims`
- Auth: API key in header `X-Decionis-API-Key`

The platform presents the permit_id it was issued; the executor host claims the grant with Decionis, once. A permit already presented, expired, or for another execution is refused, and a second presentation never reaches the authority.

## Path parameters

- `connectionId` string, uuid, required
- `executionId` string, uuid, required

## Headers

- `X-ERP-Region` string, required

## Request body

- PermitRequest
  - `permit_id` string, required

## Response `200`

CLAIMED, or BLOCKED with why

- ExecutionClaimResponse
  - `execution_id` string, required
  - `outcome` 'CLAIMED' | 'BLOCKED' | 'FAILED_BEFORE_DISPATCH', required
  - `reason_codes` string[], required
  - `permit_id` string, nullable, required
  - `intent_sha256` string, nullable, required
  - `expires_at` string, date-time, nullable, required
  - `claim_attestation` string, nullable, required: The authority's proof of the claim (compact JWS), when it gave one.

## Other responses

- `400`: Bounded error response
- `401`: Bounded error response
- `404`: Bounded error response
- `409`: Bounded error response

---

[API](https://skmtc.dev/decionis/apis/decionis-commerce-gate-api.md) · [All operations](https://skmtc.dev/decionis/apis/decionis-commerce-gate-api/llms.txt) · [OpenAPI document](https://skmtc.dev/decionis/apis/decionis-commerce-gate-api/revisions/9fecb7109bf8?raw)