# Initiate bill recipient subscription

This endpoint initiates the "Bill recipient driven subscription (Subscription at the biller)" process, returns a subscription initiation token to the caller and sends a verification code to the eBill subscribers email address. Only the primary network partner of a biller is allowed to initiate the subscription at the biller. 

Endpoint: POST /api/v1/bill-recipient-subscriptions/initiations
Version: 1.1
Security: X-API-Key

## Request fields (application/json):

  - `emailAddress` (string, required)
    Email address the user entered for subscription initiation
    Example: "hansmuster@muster.info"

## Response 201 fields (application/json):

  - `subscriptionInitiationToken` (string, required)
    subscription initiation token which will be used to confirm the subscription initiation
    Example: "0dc2ff79-db4c-4635-a4aa-f93f36ab5dbf"

## 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"