# Find events for bill recipient subscriptions which changed status

Endpoint: GET /api/v1/events/six/bill-recipient-subscription-status-changed
Version: 1.1
Security: X-API-Key

## Query parameters:

  - `lastEventSixId` (string)
    SIX ID of the last received event. If omitted, the result starts with the oldest available event. :

  - `limit` (integer)
    Maximum number of items to be returned (technical maximum is 1000, no more will be returned).

## Response 200 fields (application/json):

  - `id` (integer, required)
    Event ID
    Example: 12345

  - `sixId` (string, required)
    SIX Event ID
    Example: "EVID82A65938766547EBBBA39BA6F7B07F24"

  - `timestamp` (string, required)
    timestamp of the event
    Example: "2015-01-01T10:00Z"

  - `billRecipient` (object, required)

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

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

  - `billRecipient.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"

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

  - `billRecipient.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"

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

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

  - `billRecipient.address` (object, required)

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

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

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

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

  - `accountNumber` (string)
    Account number of the biller (e.g. iban), if provided from the financial institution

  - `referenceStructured` (string)
    QR or creditor reference number, if provided from the financial institution.
    Example: 1.2345612345678902e+26

  - `billRecipientSubscriptionFormFields` (array)

  - `billRecipientSubscriptionFormFields.technicalId` (string, required)
    The identifying token of this subscription form field. Corresponds to the property technicalId of BillerSubscriptionFormField.
    Example: "customerNumber"

  - `billRecipientSubscriptionFormFields.value` (string, required)
    The value of this subscription form field as entered by the user. If a pattern is defined, it has been checked against it.
    Example: "123-abcd-456"

  - `newStatus` (string)
    the new status of the bill recipient subscription, see "Subscriptions and subscription cancellations" for further information
    Enum: "INACTIVE", "REQUESTED", "ACTIVE"

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