Reference · Endpoints

Create a receiving endpoint

Provision the endpoint that receives value into the environment for an owner and value unit.

POST/v1/receiving-endpoints

Authorization: Bearer ak_test_… · Application API key

Idempotency-Key: <uuid> · required

Try it

This operation writes. Compose it in the playground, where you pick refs from objects you hold and pass one human check before it fires — then follow it back here.

Key capabilities

ReceivingEndpointCreate

Wire receipt

Captured from the real gateway by the scenario suite; nothing here is composed by hand.

Activate the environment's receiving endpoint: the door external value arrives through.

Request

POST /v1/receiving-endpoints
Authorization: Bearer ak_test_…
Idempotency-Key: b3631242-dec7-415c-b446-ee7a403ccc51
Content-Type: application/json

{
  "ownerRef": "cddd5764-3bf0-4781-851f-41e71d89af57",
  "ownerKind": "business-entity",
  "valueUnit": {
    "kind": "fiat",
    "currency": "NGN"
  }
}

Response · 200

{
  "status": 200,
  "body": {
    "activation": {
      "value": {
        "activationRef": "b3631242-dec7-415c-b446-ee7a403ccc51",
        "accountRef": "cddd5764-3bf0-4781-851f-41e71d89af57",
        "endpointRef": "b3631242-dec7-415c-b446-ee7a403ccc51",
        "holdingRefs": [
          "b3631242-dec7-415c-b446-ee7a403ccc51"
        ],
        "ownerRef": "cddd5764-3bf0-4781-851f-41e71d89af57",
        "ownerKind": "BusinessEntity",
        "capabilityRef": "4150504c-4943-4150-0000-000000000064",
        "valueUnit": {
          "kind": "fiat",
          "currency": "NGN"
        },
        "requestEvidenceRef": "01726101-5e4c-30c4-8d13-76621d52cee2",
        "readinessReceiptRef": "00000000-0000-0000-0000-0000000000f0",
        "idempotencyKey": "b3631242-dec7-415c-b446-ee7a403ccc51"
      },
      "freshness": "Current",
      "visibility": "Full",
      "evidence": [
        {
          "receiptRef": "01726101-5e4c-30c4-8d13-76621d52cee2",
          "source": "VaeRuntime"
        },
        {
          "receiptRef": "00000000-0000-0000-0000-0000000000f0",
          "source": "ComplianceReadiness"
        }
      ]
    }
  },
  "evidence": [
    {
      "receiptRef": "01726101-5e4c-30c4-8d13-76621d52cee2"
    },
    {
      "receiptRef": "00000000-0000-0000-0000-0000000000f0"
    }
  ]
}

captured 2026-07-11 · gateway 0.1.0 · The standing record · Open the receiving endpoint

Create a receiving endpoint

Key capabilities

Wire receipt

See also