A POS–RT link
apiKeyAuthorizationBearer <token>API key: gb_test_… or gb_live_…
id*stringGetbeel-Company?stringAct on one of the account's client companies (its id from GET /companies) instead of the key's own account. 404 company_not_found when the key cannot act on it.
uuidOK
application/json- response
id*stringobject*stringlabel*string|nullrt_serial*stringacquirer_country*string"IT""ES"acquirer_id*stringacquirer_name*stringpos_type*string"00""01"terminal_id*string|nullcontract_number*stringitinerant*booleanprovince*string|nullmunicipality*string|nullstreet*string|nullstreet_number*string|nullpostal_code*string|nullactive_from*string^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$dateended_on*|nullstatus*string"to_file""filed""end_to_file""ended"pending*|What is still to communicate to the AdE, and by when
linked_filed_at*|nullend_filed_at*|nullcreated_at*string^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$date-timeupdated_at*string^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$date-timecurl -X GET 'https://www.getbeel.com/api/v1/pos-rt-links/string'{ "id": "string", "object": "pos_rt_link", "label": "string", "rt_serial": "string", "acquirer_country": "IT", "acquirer_id": "string", "acquirer_name": "string", "pos_type": "00", "terminal_id": "string", "contract_number": "string", "itinerant": true, "province": "string", "municipality": "string", "street": "string", "street_number": "string", "postal_code": "string", "active_from": "2026-10-29", "ended_on": "2026-10-29", "status": "to_file", "pending": { "operation": "I", "from": "2026-10-29", "due": "2026-10-29", "not_late_until": "2026-10-29", "reference_month": "string", "initial_window": true }, "linked_filed_at": "2019-08-24T14:15:22Z", "end_filed_at": "2019-08-24T14:15:22Z", "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z"}Record a POS linked to an RT POST
The fields of the AdE bulk CSV: RT matricola, acquirer (codice fiscale, name, IT or ES), POS type (00 physical with its TerminalId, 01 virtual), contract number, address of the unità locale or itinerant, and the first day of use. Live keys only (403 livemode_required). Free.
Change or end a POS–RT link PATCH
Before the link is communicated anything can change. After, only label and ended_on: setting ended_on (last day of use) makes the end the next thing to communicate (operation C, DataFine). 409 link_already_filed otherwise. Live keys only (403 livemode_required). Free.