---
title: "Write a list of events to the ledger database"
method: POST
path: "/v1/event"
tags: ["Events"]
---

# Write a list of events to the ledger database

`POST /v1/event`

## Response `200`

OK

- EventTicker[]
  - `amount` integer
  - `card_brand` string
  - `event_date` string, date-time
  - `event_type` string
  - `gateway_account_id` string
  - `is_moto` boolean
  - `is_recurring` boolean
  - `payment_provider` string
  - `resource_external_id` string
  - `resource_type` 'agreement' | 'payment' | 'refund' | 'service' | 'card_payment' | 'payout' | 'dispute' | 'payment_instrument'
  - `service_external_id` string
  - `source` string
  - `transaction_type` string
  - `wallet_type` string

## Other responses

- `422` — Missing query parameters
- `500` — Invalid parameters or Downstream system error

## Changes

- **2025-01-16** `ef12d134c115` — 1 warning
  - added the new `AMOUNT_BELOW_MINIMUM` enum value to the `error_identifier` response property for the response status `422`
- **2024-11-25** `6a7b3b19bd40` — 1 warning
  - added the new `NON_HTTPS_RETURN_URL_NOT_ALLOWED_FOR_A_LIVE_ACCOUNT` enum value to the `error_identifier` response property for the response status `422`
- **2024-07-04** `f0a1163783f3` — 5 info
  - added the optional property `items/is_moto` to the response with the `200` status
  - added the optional property `items/is_recurring` to the response with the `200` status
  - added the optional property `items/service_external_id` to the response with the `200` status
  - added the optional property `items/source` to the response with the `200` status
  - …1 more
- **2023-07-27** `74a9d73d8fc5` — 1 info
  - the request property `items/event_details` became optional
- **2023-07-21** `cf21f4054d32` — 5 breaking, 3 info
  - the request property `items/event_details` became required
  - the request property `items/event_type` became required
  - the request property `items/resource_external_id` became required
  - the request property `items/resource_type` became required
  - …4 more

[Full history](https://skmtc.dev/government-digital-service/apis/ledger-api/changes/v1/event/post.md)

---

[API](https://skmtc.dev/government-digital-service/apis/ledger-api.md) · [All operations](https://skmtc.dev/government-digital-service/apis/ledger-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/government-digital-service/ledger-api/revisions/10ffeffca918/schema)