---
title: "B2CFI API"
canonical: https://documentation.maventa.com/api-specification/rest-api/b2cfi-api/
---

The B2CFI API handles Finnish consumer invoicing (B2C) via the banking network. Use it to send and manage bank messages — SI (SenderInfo), RI (ReceiverInfo), and RP (ReceiverProposal) — that are needed to set up and maintain consumer e-invoicing agreements with Finnish banks.

For a full walkthrough of the activation process and message flow, see the [consumer invoicing guide for Finland](https://documentation.maventa.com/integration-guide/invoice-sending/consumer-invoicing/fi/).

## API endpoints

### GET /v1/fi_bank_messages/ri_messages

List IDs of incoming RI messages within given timeframe

**Parameters**

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| timestamp_start | query | string | yes | Start timestamp |
| timestamp_end | query | string | yes | End timestamp |

**Responses**

| Status | Description | Schema |
| --- | --- | --- |
| 200 | Array of ids, e.g. ["id1", "id2"] |  |

### GET /v1/fi_bank_messages/ri_messages/{id}

Get content of single RI message

**Parameters**

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| id | path | string | yes | Message ID |

**Responses**

| Status | Description | Schema |
| --- | --- | --- |
| 200 | Get content of single RI message |  |

### DELETE /v1/fi_bank_messages/ri_messages/{id}

Delete a single RI message

**Parameters**

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| id | path | string | yes | Message ID |

**Responses**

| Status | Description | Schema |
| --- | --- | --- |
| 204 | Message deleted successfully |  |

### GET /v1/fi_bank_messages/sent_messages

List IDs of sent messages within given timeframe

**Parameters**

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| message_type | query | string | yes | Message Type |
| timestamp_start | query | string | yes | Start timestamp |
| timestamp_end | query | string | yes | End timestamp |

**Responses**

| Status | Description | Schema |
| --- | --- | --- |
| 200 | Array of ids, e.g. ["id1", "id2"] |  |

### GET /v1/fi_bank_messages/sent_messages/{id}

Get content of single message

**Parameters**

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| id | path | string | yes | Message ID |

**Responses**

| Status | Description | Schema |
| --- | --- | --- |
| 200 | Get content of single message |  |

### GET /v1/fi_bank_messages/error_messages

List IDs of incoming error messages within given timeframe

**Parameters**

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| timestamp_start | query | string | yes | Start timestamp |
| timestamp_end | query | string | yes | End timestamp |

**Responses**

| Status | Description | Schema |
| --- | --- | --- |
| 200 | Array of ids, e.g. ["id1", "id2"] |  |

### GET /v1/fi_bank_messages/error_messages/{id}

Get content of single error message

**Parameters**

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| id | path | string | yes | Message ID |

**Responses**

| Status | Description | Schema |
| --- | --- | --- |
| 200 | Get content of single error message |  |

### POST /v1/fi_bank_messages

Upload new message

**Parameters**

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| file | formData | file | yes | File content |

**Responses**

| Status | Description | Schema |
| --- | --- | --- |
| 204 | Message uploaded successfully |  |

### GET /v1/fi_bank_messages/{id}

Get status of sent message

**Parameters**

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| id | path | string | yes | Message ID |

**Responses**

| Status | Description | Schema |
| --- | --- | --- |
| 200 | Get status of sent message | `FiBankMessages_HttpApi_Entities_FiBankMessageStatus` |


_OpenAPI spec snapshot: 2026-05-06_