Start links

POST /v1/verification-sessions

Start MitID Erhverv verification

settings:write

Returns a link a human opens; payouts are gated on the verification. Call again for status.

Request exampleNo request body

curl

curl -X POST https://api.rieckflow.com/v1/verification-sessions \
  -H "Authorization: Bearer $RIECK_API_KEY" \
  -H "Idempotency-Key: order-2041"

TypeScript

const svar = await rieck.request("POST", "/v1/verification-sessions");

Response

{
  "data": {
    "url": "https://app.rieckflow.com/api/creditor/mitid-verification/start",
    "status": "pending",
    "verifiedAt": null,
    "cvr": "12345678",
    "payoutGateActive": true
  }
}

200 Success envelopeapplication/json

Response fields 3

Field	Type	Description
data.url	url | null	Browser flow a human must complete.
data.status	pending | verified	Current MitID Erhverv status.
data.payoutGateActive	boolean	Whether payouts remain blocked.

Possible errors 8

HTTP	Code	Meaning
400	invalid_idempotency_key	Idempotency-Key is missing or malformed.
401	invalid_api_key	The API key is missing, invalid, expired or revoked.
403	api_not_included	The organisation’s plan does not include API access.
403	insufficient_scope	The key does not have the required scope.
409	idempotency_conflict	The same key was used with a different request.
409	idempotency_in_progress	The same operation is currently being processed. Retry later.
429	rate_limited	The organisation’s rate budget is exhausted.
503	verification_unavailable	MitID verification is temporarily unavailable.

---

POST /v1/card-setup-sessions

Start card setup (hosted fields)

settings:write

Card data never passes this API.

Request exampleNo request body

curl

curl -X POST https://api.rieckflow.com/v1/card-setup-sessions \
  -H "Authorization: Bearer $RIECK_API_KEY" \
  -H "Idempotency-Key: order-2041"

TypeScript

const svar = await rieck.request("POST", "/v1/card-setup-sessions");

Response

{
  "data": {
    "url": "https://app.rieckflow.com/admin/subscription",
    "hasActiveCard": false
  }
}

200 Success envelopeapplication/json

Possible errors 8

HTTP	Code	Meaning
400	invalid_idempotency_key	Idempotency-Key is missing or malformed.
401	invalid_api_key	The API key is missing, invalid, expired or revoked.
403	api_not_included	The organisation’s plan does not include API access.
403	insufficient_scope	The key does not have the required scope.
409	idempotency_conflict	The same key was used with a different request.
409	idempotency_in_progress	The same operation is currently being processed. Retry later.
429	rate_limited	The organisation’s rate budget is exhausted.
503	card_setup_unavailable	Hosted card setup is temporarily unavailable.

---

POST /v1/accounting-connections

Start accounting OAuth

settings:write

Returns a link; reports the current connection.

Request exampleNo request body

curl

curl -X POST https://api.rieckflow.com/v1/accounting-connections \
  -H "Authorization: Bearer $RIECK_API_KEY" \
  -H "Idempotency-Key: order-2041"

TypeScript

const svar = await rieck.request("POST", "/v1/accounting-connections");

Response

{
  "data": {
    "url": "https://app.rieckflow.com/admin/accounting",
    "connection": {
      "provider": "dinero",
      "status": "active",
      "lastTestedAt": "2026-08-04T09:32:11Z",
      "lastTestOk": true
    }
  }
}

200 Success envelopeapplication/json

Possible errors 7

HTTP	Code	Meaning
400	invalid_idempotency_key	Idempotency-Key is missing or malformed.
401	invalid_api_key	The API key is missing, invalid, expired or revoked.
403	api_not_included	The organisation’s plan does not include API access.
403	insufficient_scope	The key does not have the required scope.
409	idempotency_conflict	The same key was used with a different request.
409	idempotency_in_progress	The same operation is currently being processed. Retry later.
429	rate_limited	The organisation’s rate budget is exhausted.