Reference · Endpoints

Read the current receiving endpoint

Resolve the active receiving endpoint for an owner and value unit.

GET/v1/receiving-endpoints/current

Authorization: Bearer ak_test_… · Application API key

Try it

This read needs refs from objects you hold; the docs' own refs live in the exhibition, not your bench. Compose it in the playground against your own world.

Key capabilities

ReceivingEndpointRead

Parameters

ownerKindquery · required

currencyquery · optional

assetquery · optional

ownerRefquery · required

valueUnitKindquery · required

networkquery · optional

instrumentRefquery · optional

Contract notes

publicProjectioncustomer_usable_receiving_endpoint

disallowedResponseFieldsintentFingerprint · endpointFingerprint · policyFingerprint

Sharp edges

The locator is the full owner and value-unit form. Fields that do not apply to the value unit are passed empty, not omitted.

Wire receipt

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

Read the activation back; the projection carries the account, endpoint, and holding refs every later call uses.

Request

GET /v1/receiving-endpoints/current?ownerRef=cddd5764-3bf0-4781-851f-41e71d89af57&ownerKind=business-entity&valueUnitKind=fiat&currency=NGN
Authorization: Bearer ak_test_…

Response · 200

{
  "status": 200,
  "body": {
    "value": {
      "resource": {
        "activationRef": "b3631242-dec7-415c-b446-ee7a403ccc51",
        "endpointRef": "b3631242-dec7-415c-b446-ee7a403ccc51",
        "ownerRef": "cddd5764-3bf0-4781-851f-41e71d89af57",
        "ownerKind": "BusinessEntity",
        "capabilityRef": "4150504c-4943-4150-0000-000000000064",
        "holdingUnits": [
          {
            "kind": "fiat",
            "currency": "NGN"
          }
        ],
        "availability": "Available",
        "freshness": "Current"
      },
      "account": {
        "accountRef": "cddd5764-3bf0-4781-851f-41e71d89af57",
        "ownerRef": "cddd5764-3bf0-4781-851f-41e71d89af57",
        "ownerKind": "BusinessEntity",
        "endpointRef": "b3631242-dec7-415c-b446-ee7a403ccc51",
        "holdingRefs": [
          "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 · Read the receiving endpoint

generated from openapi.json · gateway 0.1.0 · sandbox