---
title: "B2CNO API"
canonical: https://documentation.maventa.com/api-specification/rest-api/b2cno-api/
---

The B2CNO API handles Norwegian consumer invoicing (B2C). Use it to manage the vendor agreements and consumer registrations needed for eFaktura delivery (to netbanks and Vipps) and AvtaleGiro direct debit. It also covers AutoGiro (ATG) mandate management.

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

## API endpoints

### GET /v1/services/b2cno/consumers

List B2CNO Consumers - DEPRECATED 2025

**Parameters**

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| query | query | string | no | List by phonenumber, name, customer_number and reference_number |
| status | query | array[string] | no | List of statuses |
| page | query | integer | no | Page to fetch |
| per_page | query | integer | no | Number of items per page, values up to 100 supported |

**Responses**

| Status | Description | Schema |
| --- | --- | --- |
| 200 | List B2CNO Consumers - DEPRECATED 2025 | `array[API_Entities_CompanyConsumers_Consumer]` |

### GET /v1/services/b2cno

Information about B2CNO agreement

**Responses**

| Status | Description | Schema |
| --- | --- | --- |
| 200 | Information about B2CNO agreement | `API_Entities_B2CNO_Status` |

### GET /v1/services/atg

List ATG agreements

**Responses**

| Status | Description | Schema |
| --- | --- | --- |
| 200 | List ATG agreements | `array[API_Entities_CompanyAgreements_Atg]` |

### POST /v1/services/atg

Create a new ATG agreement

**Request body**

Schema: `postV1ServicesAtg`

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| account_number | `string` | yes | Account number linked to agreement |
| kid_length | `integer` | yes | Length of KID |
| reference_position | `string` | yes | The reference position in the KID |
| payment_type_position | `string` | no | The payment type position in the KID |
| signer_email | `string` | yes | Email for possible agreement signature request if required |
| notification_by_print | `boolean` | no | Send notification about ATG invoice by print |
| notification_by_email | `boolean` | no | Send notification about ATG invoice by email |

**Responses**

| Status | Description | Schema |
| --- | --- | --- |
| 201 | Create a new ATG agreement | `API_Entities_CompanyAgreements_Atg` |

### GET /v1/services/atg/mandates

List B2C ATG mandates

**Parameters**

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| query | query | string | no | Find by KID or reference |
| timestamp | query | string | no | Timestamp for latest update |
| status | query | string | no | Status |
| parse_values | query | string | no | Parse reference and payment type from KID.Only works for <20 results |
| page | query | integer | no | Page to fetch |
| per_page | query | integer | no | Number of items per page, values up to 100 supported |

**Responses**

| Status | Description | Schema |
| --- | --- | --- |
| 200 | List B2C ATG mandates | `array[API_Entities_CompanyConsumers_Mandate]` |

### GET /v1/services/atg/{account_number}

Fetch ATG agreement

**Parameters**

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| account_number | path | string | yes | Account number |

**Responses**

| Status | Description | Schema |
| --- | --- | --- |
| 200 | Fetch ATG agreement | `API_Entities_CompanyAgreements_Atg` |

### PATCH /v1/services/atg/{account_number}

Update existing ATG agreement

**Parameters**

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| account_number | path | string | yes | Account number linked to agreement |

**Request body**

Schema: `patchV1ServicesAtgAccountNumber`

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| kid_length | `integer` | yes | Length of KID |
| reference_position | `string` | yes | The reference position in the KID |
| payment_type_position | `string` | no | The payment type position in the KID |
| signer_email | `string` | yes | Email for possible agreement signature request if required |
| notification_by_print | `boolean` | no | Send notification about ATG invoice by print |
| notification_by_email | `boolean` | no | Send notification about ATG invoice by email |

**Responses**

| Status | Description | Schema |
| --- | --- | --- |
| 204 | ATG agreement updated succesfully |  |


_OpenAPI spec snapshot: 2026-05-06_