Download OpenAPI specification:Download
Operations exposed by the Issuer Bank for Amiko to send events.
Submit an event related to Amiko. See the details for the different types of events.
| tracing-id required | string Tracing ID that can be used to track interactions. |
| auth_header | string This is going to be where we send the API key. The header will consist of a custom api key or standardised JWT auth. |
required | object (event.header) |
required | any |
{- "header": {
- "version": "2025.4.0",
- "eventId": "93a5bbf3-48f4-4786-93af-6437331aea9a",
- "generatedAt": 0
}, - "event": {
- "type": "case_created",
- "cardholderId": "2bd52a45-129d-4723-9143-e1c5b5ed34e7",
- "cardId": "b8ba25f3-c945-4ed0-9d4d-e3153a0dd048",
- "caseId": "1234",
- "caseType": "fraud",
- "createdVia": "cardholder_self_service"
}
}{- "error": {
- "message": "string",
- "description": "string"
}
}Submit a domain event related to Amiko. See the details for the different types of events.
| tracing-id required | string Tracing ID that can be used to track interactions. |
| auth_header | string This is going to be where we send the API key. The header will consist of a custom api key or standardised JWT auth. |
required | object (domain_event.header) |
required | any (domain_event.body) |
{- "header": {
- "eventId": "93a5bbf3-48f4-4786-93af-6437331aea9a",
- "generatedAt": 0,
- "entity": {
- "type": "string",
- "id": "string"
}, - "serial": 512,
- "causedBy": "agent",
- "agentId": "61f925fa-653b-46f0-9117-d03040e9b775"
}, - "event": {
- "event_name": "case_created",
- "caseId": "1234",
- "cardId": "b8ba25f3-c945-4ed0-9d4d-e3153a0dd048",
- "createdVia": "cardholder_self_service"
}
}{- "error": {
- "message": "string",
- "description": "string"
}
}The specification is based on the IETF draft linked below. Its content consists of a single mandatory root field (“status”) and several optional fields. Health Check Response Format for HTTP APIs: https://inadarei.github.io/rfc-healthcheck/
| auth_header | string This is going to be where we send the API key. The header will consist of a custom api key or standardised JWT auth. |
{- "status": "fail"
}