splitbill

{'type': 'object', 'required': [], 'properties': {'note': {'type': 'string', 'description': 'A short note shown to the payers.'}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['amount'], 'properties': {'label': {'type': 'string', 'description': 'What the line is for (e.g. Food).'}, 'amount': {'type': 'number'}}}, 'description': 'Receipt lines. Their sum becomes the total. Payers can see them.'}, 'names': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Names of the others (only the ones you know). Empty slots get filled in by the payers themselves.'}, 'title': {'type': 'string', 'description': 'What the bill was for (e.g. Friday dinner). Defaults to the date and time.'}, 'total': {'type': 'number', 'description': 'The total. If items are given, their sum wins.'}, 'custom': {'type': 'array', 'items': {'type': 'object', 'required': ['amount'], 'properties': {'name': {'type': 'string', 'description': 'A name passed in names.'}, 'index': {'type': 'number', 'description': 'Position when there is no name (counting from 1; 1 is the user).'}, 'amount': {'type': 'number'}}}, 'description': 'Charge one person a different amount (e.g. someone who did not drink). The rest is re-split automatically.'}, 'i_paid': {'type': 'boolean', 'description': 'Did the user pay up front? (default: true) They count towards the head count but are not billed.'}, 'people': {'type': 'number', 'description': 'How many people share the bill, INCLUDING the user who paid up front.'}, 'my_name': {'type': 'string', 'description': 'What to call the user in the list (default: Me).'}, 'children': {'type': 'number', 'description': 'How many of people are children. A child pays half of what an adult pays. "4 adults and 3 kids" is people=7, children=3. When names are given, the LAST ones on the list are taken to be the children.'}, 'rounding': {'enum': ['ceil-all', 'one-extra'], 'type': 'string', 'description': 'Rounding. ceil-all = round everyone up to whole dollars and let the user absorb the difference; one-extra = split exactly and let one person carry the remainder.'}}}

{'type': 'object', 'required': ['summary', 'total', 'people', 'manage_url', 'share_urls', 'paynow', 'next_step'], 'properties': {'total': {'type': 'number', 'description': 'The total.'}, 'paynow': {'type': 'object', 'required': ['target'], 'properties': {'name': {'type': ['string', 'null']}, 'target': {'type': 'string'}}, 'description': 'Who collects the money (saved with this connection).'}, 'people': {'type': 'number', 'description': 'How many share the bill, including whoever paid up front.'}, 'summary': {'type': 'string', 'description': 'A one-line summary to read out (how much each, how many people).'}, 'warnings': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Anything worth mentioning about rounding or head count.'}, 'next_step': {'type': 'string', 'description': 'What to do next.'}, 'manage_url': {'type': 'string', 'description': 'Manage URL. FOR THE ORGANISER ONLY — it can change the split.'}, 'share_urls': {'type': 'array', 'items': {'type': 'object', 'required': ['amount', 'people', 'url'], 'properties': {'url': {'type': 'string'}, 'amount': {'type': 'number'}, 'people': {'type': 'number', 'description': 'How many people owe this amount.'}}}, 'description': 'Share URLs — one per amount.'}, 'status_url': {'type': ['string', 'null'], 'description': 'Read-only URL. Safe to share.'}}}

{'type': 'object', 'required': ['admin_token'], 'properties': {'admin_token': {'type': 'string', 'description': 'The t= value from the manage URL, or the whole manage URL.'}}}

{'type': 'object', 'required': ['title', 'total', 'collected', 'people', 'members', 'share_urls', 'paynow'], 'properties': {'title': {'type': 'string'}, 'total': {'type': 'number'}, 'paynow': {'type': 'object', 'required': ['target'], 'properties': {'name': {'type': ['string', 'null']}, 'target': {'type': 'string'}}}, 'people': {'type': 'number'}, 'members': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'amount', 'state'], 'properties': {'name': {'type': 'string'}, 'state': {'type': 'string', 'description': 'One of: paid up front (not billed) / paid / unpaid.'}, 'adults': {'type': 'number', 'description': 'Adults in this household (default 1).'}, 'amount': {'type': 'number'}, 'comment': {'type': ['string', 'null'], 'description': 'A note left by the payer.'}, 'children': {'type': 'number', 'description': 'Children in this household. A child pays half an adult.'}}}}, 'collected': {'type': 'number', 'description': 'How much has come in.'}, 'share_urls': {'type': 'array', 'items': {'type': 'object', 'required': ['amount', 'url'], 'properties': {'url': {'type': 'string'}, 'amount': {'type': 'number'}}}}, 'status_url': {'type': ['string', 'null']}}}

{'type': 'object', 'required': [], 'properties': {'limit': {'type': 'number', 'description': 'How many to return (default 10, max 50).'}}}

{'type': 'object', 'required': ['splits'], 'properties': {'note': {'type': 'string'}, 'splits': {'type': 'array', 'items': {'type': 'object', 'required': ['title', 'total', 'collected', 'paid_people', 'people'], 'properties': {'title': {'type': 'string'}, 'total': {'type': 'number'}, 'people': {'type': 'number'}, 'disabled': {'type': 'boolean', 'description': 'Whether the split has been stopped.'}, 'collected': {'type': 'number', 'description': 'How much has come in, counting what was fronted.'}, 'created_at': {'type': 'string', 'description': 'When it was created (ISO 8601).'}, 'status_url': {'type': ['string', 'null'], 'description': 'Read-only URL.'}, 'paid_people': {'type': 'number', 'description': 'How many have paid.'}}}, 'description': 'Newest first.'}}}