# Confirm bill recipient subscription initiation

This endpoint verifies the combination of subscription initiation token and activation code. If the combination is valid, it creates an active biller relation. Only the primary network partner of a biller is allowed to confirm the subscription at the biller initiation. 

Endpoint: PUT /api/v1/bill-recipient-subscriptions/initiations/{subscriptionInitiationToken}
Version: 1.1
Security: X-API-Key

## Path parameters:

  - `subscriptionInitiationToken` (string, required)
    subscription initiation token

## Request fields (application/json):

  - `activationCode` (string, required)
    activation code provided by the user
    Example: 123456

## Response 200 fields (application/json):

  - `emailAddress` (string)
    email address of the bill recipient
    Example: "peter@muster.ch"

  - `billRecipientSixId` (string, required)
    SIX ID of the bill recipient
    Example: 41010560425610180

  - `enterpriseIdentificationNumber` (string)
    Swiss enterprise identification number (UID) without dashes, dots or extension. Note that this has to contain the swiss enterprise identification number (UID) from the commercial register (Handelsregister) which may be different from the VAT UID (Mehrwertsteuer UID).
    Example: "CHE123456789"

  - `type` (string, required)
    the type of the bill recipient
    Enum: "PRIVATE", "COMPANY"

  - `name` (string, required)
    last name, if private bill recipient company name, if company bill recipient
    Example: "for private bill recipient: Muster, for company name: Muster AG"

  - `firstName` (string)
    first name, if private bill recipient empty, if company bill recipient
    Example: "Peter"

  - `correspondenceLanguage` (string, required)
    language for correspondence with this bill recipient ISO-639-2/B
    Example: "ger"

  - `address` (object, required)

  - `address.streetName` (string, required)
    street name
    Example: "Neustadtstrasse"

  - `address.postalCode` (string, required)
    postal code
    Example: 6025

  - `address.city` (string, required)
    city name
    Example: "Neudorf"

  - `address.countryCode` (string, required)
    in format ISO 3166-1 alpha 2
    Example: "CH"

## Response 400 fields (application/json):

  - `status` (integer)
    The HTTP status code generated by the origin server for this occurrence of the problem.
    Example: 400

  - `message` (string)
    A human readable explanation specific to this occurrence of the problem.
    Example: "The submitted request contains invalid or missing data which can not be processed."

  - `fieldErrors` (array)

  - `fieldErrors.fieldName` (string)
    the name of the field with the error
    Example: "localizedData.ger.address.city"

  - `fieldErrors.message` (string)
    the message describing the error
    Example: "size must be between 1 and 35"

  - `fieldErrors.rejectedValue` (string)
    the provided value which was rejected if available
    Example: "Very Long Invalid City Name Which Is Rejected"