Bank accounts

Bank accounts are where Place2Book pays out ticket revenue. An event maker can have several, and each event can choose which one receives its payout.

You can create an account from a registration number and account number, or from just a CVR number. With only a CVR number, the payout goes to the company’s NemKonto.

The bank account object

Field	Type	Description
`id`	`integer`	Unique identifier.
`name`	`string`	Name of the account, used to tell accounts apart.
`account_prefix`	`string`	Bank registration number (4 digits).
`account_number`	`string`	Account number (up to 10 digits).
`cvr`	`string`	CVR number of the account holder (8 digits).
`cpr`	`string`	CPR number of the account holder (10 digits), for private persons.
`address`	`object`	Address of the account holder. Left out if none is stored.
`address.address1`	`string`	Street address.
`address.postal_code`	`string`	Postal code.
`address.city`	`string`	City.
`address.phone`	`string`	Phone number.
`address.country`	`string`	ISO 3166-1 alpha-2 country code.

{
  "id": 7654321,
  "name": "Eventbureauets driftskonto",
  "account_prefix": "1234",
  "account_number": "0012345678",
  "cvr": "28888880",
  "cpr": null,
  "address": {
    "address1": "Nørrelundvej 5",
    "postal_code": "2730",
    "city": "Herlev",
    "phone": "+4570232550",
    "country": "DK"
  }
}

List bank accounts

GET/event_makers/:event_maker_id/bank_accounts

Response200 OK

[
  {
    "id": 7654321,
    "name": "Eventbureauets driftskonto",
    "account_prefix": "1234",
    "account_number": "0012345678",
    "cvr": "28888880",
    "cpr": null,
    "address": {
      "address1": "Nørrelundvej 5",
      "postal_code": "2730",
      "city": "Herlev",
      "phone": "+4570232550",
      "country": "DK"
    }
  }
]

Possible errors404 Not Found

Get a bank account

GET/event_makers/:event_maker_id/bank_accounts/:bank_account_id

Response200 OK

{
  "id": 7654321,
  "name": "Eventbureauets driftskonto",
  "account_prefix": "1234",
  "account_number": "0012345678",
  "cvr": "28888880",
  "cpr": null,
  "address": {
    "address1": "Nørrelundvej 5",
    "postal_code": "2730",
    "city": "Herlev",
    "phone": "+4570232550",
    "country": "DK"
  }
}

Possible errors404 Not Found

Create a bank account

POST/event_makers/:event_maker_id/bank_accounts

Parameters

Parameter	Type	Description
`name`	`string`	required Name of the account, at most 50 characters.
`email`	`string`	required Email address of the account holder.
`full_name`	`string`	Full name of the account holder.
`account_prefix`	`string`	Bank registration number, exactly 4 digits.
`account_number`	`string`	Account number, up to 10 digits.
`cvr`	`string`	CVR number, exactly 8 digits.
`cpr`	`string`	CPR number, exactly 10 digits.
`address`	`object`	Address of the account holder, with `address1`, `address2`, `postal_code`, `city`, `phone` and `country`.

Request body

{
  "bank_account": {
    "name": "Eventbureauets driftskonto",
    "full_name": "Eventbureauet ApS",
    "email": "economy@eventbureauet.dk",
    "account_prefix": "1234",
    "account_number": "0012345678",
    "cvr": "28888880"
  }
}

Response201 Created

Location: https://api.place2book.com/event_makers/1234567/bank_accounts/7654321

{
  "id": 7654321,
  "name": "Eventbureauets driftskonto",
  "account_prefix": "1234",
  "account_number": "0012345678",
  "cvr": "28888880",
  "cpr": null,
  "address": {
    "address1": "Nørrelundvej 5",
    "postal_code": "2730",
    "city": "Herlev",
    "phone": "+4570232550",
    "country": "DK"
  }
}

Possible errors404 Not Found 422 Unprocessable Content

Update a bank account

PUT/event_makers/:event_maker_id/bank_accounts/:bank_account_id

Takes the same parameters as create. Every field except address is set from the request, so send the complete object.

Response200 OK

{
  "id": 7654321,
  "name": "Eventbureauets driftskonto",
  "account_prefix": "1234",
  "account_number": "0012345678",
  "cvr": "28888880",
  "cpr": null,
  "address": {
    "address1": "Nørrelundvej 5",
    "postal_code": "2730",
    "city": "Herlev",
    "phone": "+4570232550",
    "country": "DK"
  }
}

Possible errors404 Not Found 422 Unprocessable Content

Delete a bank account

DELETE/event_makers/:event_maker_id/bank_accounts/:bank_account_id

Response204 No Content

Possible errors404 Not Found 424 Failed Dependency