{"info":{"_postman_id":"d1926441-fcff-43b1-907a-1a240d7eefbc","name":"Roger API (Roger.ai)","description":"

Welcome to Roger's API reference documentation. Here you can download and import Roger API Postman collection. Feel free to reach out to support@roger.ai if you have any questions. We also have a Slack community where you will be able to get even faster assistance or answers for your questions. Join here

Expense life-cycle

Before starting it is important to understand a few concepts in Roger. A crucial and central concept is the life-cycle of an expense. When any expense is uploaded to Roger, the expense will follow a flow representing the life-cycle of an expense. The life-cycle is defined as a graph G = (V,E) where all vertices in V is the available states an expense can have. An expense can only hold one state at any time. E is the abstract set of valid paths between two or more vertices. All states have a set of predefined actions associated with every exit and entry transition of a vertex.

\n\n

States

This is the list of available state for any expense in Roger.

Pending

This state identifies the process where the expense is getting recognized. The progressing time can vary depending on the complexity or/and the need for additional compliance checks.

Awaiting

If the corresponding company has an active Workflow and the expense properties match an active rule with the need for approval, the expense will reside in this state until a user has either approve or decline the expense. Please note that an expense waiting for approval might reside in this state eventhough it got approve if there is a rule waiting for two approvers. You could imagine a flow where User A and User B is required for the given expense to be approved, when User A approves the webhook emitted would be expense.approval.approve and when User B then consecutively approves it will change state and emit expense.approval.approve and expense.state.booked (Assuming it moves to the Booked state)

Webhook emitted when entering: expense.state.awating

Booked

When an expense of the type bill is ready for payment it will reside in this state until canceled or initialized. It can move to initialized automatically on due or by manually paying the bill.\n
Webhook emitted when entering: expense.state.booked

Initialized

If the expense is getting paid outside banking hours - either by a user or by the API - the expense will move to `Initialized` and automatically get paid when the sending bank allows for a successful transaction\n
Webhook emitted when entering: `expenses.state.initialized`

Paid

This state identifies that an expense has been either been paid successfully or has been marked as paid.\n
Webhook emitted when entering: expenses.state.paid

Paused

If an expense of the type bill has failed due to issues related to a third party such as the bank, insufficient funds etc. it will be moved to this state.\n
Webhook emitted when entering: expense.state.paused

Canceled / Declined

If an expense is deleted - either by Roger or by a user associated to the company - it will end in this state. This state is a final state and no modifications to the expense is possible here.\n
Webhook emitted when entering: expense.state.canceled

Using Webhooks

In addition to the common REST calls available in this documentation, you will be able to get your application to react on every state (described above) change in the system e.g. if a bill is paid, you want your application to write out message. In this case you subscribe to the emitted webhook expense.state.booked and from the corresponding payload you will be able to extract the context.

Events

Webhook events are identified by a string constructed by the following: [entity].[concept].[operation]. The entity defined the top-level objects e.g. expense, paymentmethod. The concept and operation is defining the action that emitted the webhook. So let's assume you have a user that is approving a certain bill waiting for approval. Here a webhook with the event expense.approval.approved is emitted. If the user instead declined the bill, the webhook would look like this expense.approval.declined.

Expense events

The following the events are emitted when changes are happening to any given bill applicable for this event. Note that some expense e.g. don't allow date change.

Concept: note, operation { updated }\n
\nConcept: label, operation { updated }\n
\nConcept: date, operation { updated }\n
\nConcept: amountlines, operation { updated }\n
\nConcept: department, operation { updated }

Team events

The following the events are emitted when changes are happening to the company account.

Concept: paymentmethod : Operation { created, deleted }

Endpoints

Test: https://staging-external.roger.ai
Demo: https://sandbox.roger.ai
Production: https://external.roger.ai (will move to https://api.roger.ai shortly)

OAUTH

Authorize URI: {{host}}/connect/authorize
Token URI: {{host}}/connect/token

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"Expense life-cycle","slug":"expense-life-cycle"},{"content":"Using Webhooks","slug":"using-webhooks"},{"content":"Endpoints","slug":"endpoints"},{"content":"OAUTH","slug":"oauth"}],"owner":"7731170","collectionId":"d1926441-fcff-43b1-907a-1a240d7eefbc","publishedId":"TzeUm8ZB","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"EF5B25"},"publishDate":"2021-06-14T09:47:38.000Z"},"item":[{"name":"Auth","item":[{"name":"Token (refresh token)","event":[{"listen":"test","script":{"id":"1080fe4d-b44f-406f-982b-0158901142c6","exec":["var data = JSON.parse(responseBody);","postman.setGlobalVariable(\"external-api-token\", data.access_token);"],"type":"text/javascript"}}],"id":"e9868581-1c88-4c81-9c5f-9affeaa29bb6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/x-www-form-urlencoded"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"grant_type","value":"authorization_code","type":"text"},{"key":"client_id","value":"{{client_id}}","type":"text"},{"key":"client_secret","value":"{{client_secret}}","type":"text"},{"key":"code","value":"{{code}}","type":"text"},{"key":"redirect_uri","value":"{{redirect_uri}}","type":"text"}]},"url":"{{host}}/connect/token","description":"

⚠️ PREVIEW

In order to generate a new refresh token you need to provide the following client_id, client_secret, authorization_code and redirect_uri in your request.

\n","urlObject":{"path":["connect","token"],"host":["{{host}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"e9868581-1c88-4c81-9c5f-9affeaa29bb6"},{"name":"Token (access token)","event":[{"listen":"test","script":{"id":"83259cbf-a5fb-4ffa-a241-252503b5ee3d","exec":["var data = JSON.parse(responseBody);","postman.setGlobalVariable(\"external-api-token\", data.access_token);"],"type":"text/javascript"}}],"id":"e6c7f23f-7d90-4e7d-825f-d685e2d539a5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"basic","basic":{"basicConfig":[{"key":"username","value":""},{"key":"password","value":""}],"advancedConfig":[{"key":"showPassword","value":""}]},"isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/x-www-form-urlencoded"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"grant_type","type":"text","value":"refresh_token"},{"key":"refresh_token","type":"text","value":"{{refresh_token}}"}]},"url":"{{host}}/connect/token","description":"

⚠️ PREVIEW

In order to generate a new token you need to provide the following refresh_token, client_id and client_secret in your request. In order to successfully generate the access token, you need to use the basic authentication for the request and provide the client_id as the user name and the client_secret as the password.

\n","urlObject":{"path":["connect","token"],"host":["{{host}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"e6c7f23f-7d90-4e7d-825f-d685e2d539a5"}],"id":"7ee052a1-46bb-40fc-bb9b-462439356f72","description":"

This API uses the OAuth 2.0 standard to handle authorization.

Create a Roger App

Please contact support@roger.ai to enable for you the Developer Portal feature. As soon as you have it enabled please go in Roger Web navigate to /developers and choose to create a new App.

Refresh Token

In order to generate a new refresh token, you need to have the offline_access API scope enabled for your Roger App and authorization code which can be generated by accessing the Auth Url in your newly created Roger application. Bear in mind the authorization code can be used only once, as soon as a request has been made to the server the authorization code becomes invalid.

Access Token

Please use your refresh token for generating access tokens.

\n","event":[{"listen":"prerequest","script":{"id":"e57f9684-3378-42ce-9455-e057de3a36a2","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"92b23224-df78-4354-862b-05416634ccb9","type":"text/javascript","exec":[""]}}],"_postman_id":"7ee052a1-46bb-40fc-bb9b-462439356f72","auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"d1926441-fcff-43b1-907a-1a240d7eefbc","id":"d1926441-fcff-43b1-907a-1a240d7eefbc","name":"Roger API (Roger.ai)","type":"collection"}}},{"name":"Expenses","item":[{"name":"Upload","id":"0cdc3aa7-aa1d-4891-96b6-d2fccdfee0fc","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{external-api-token}}"}]},"isInherited":false},"method":"POST","header":[{"warning":"This is a duplicate header and will be overridden by the Authorization header generated by Postman.","key":"Authorization","value":"Bearer {{access_token}}"},{"key":"Content-Type","value":"multipart/form-data","type":"text"}],"body":{"mode":"formdata","formdata":[{"description":"

Supported formats \"pdf\", \"png\", \"jpeg\", \"bmp\", \"tiff\"

\n","key":"files","type":"file","value":null},{"key":"teamId","value":"{{teamId}}","description":"

Required field

\n","type":"text"},{"key":"financialDocumentType","value":"{{financialDocumentType}}","description":"

Optional. \nFinancial document types ({{financial_documentType}}): 0 for Bill, 1 for Receipt, 2 for Credit Note. The default is the Bill value.

\n","type":"text"}]},"url":"{{host}}/v2/expenses","description":"

⚠️ PREVIEW

Upload an expense.

Scopes: expenses.all (optional) and/or expenses.create.

\nSupported formats: pdf, png, jpeg, bmp, tiff, xml.

\nOn a successful request the endpoint will respond with 201 Created with a full expense payload:

id: the ID of the expense.
amount: the amount in smallest common currency unit i.e. cents, øre etc.
currency: the currency e.g. DKK, USD etc.
state: the state can be pending, booked, awaiting, paid, duplicate or cancelled.
referenceDate: timestamp for current state.
issueDate: available in state of booked, awaiting, paid, duplicate and sometimes cancelled.
dueDate: available in state of booked, awaiting, paid, duplicate and sometimes cancelled.
isDueDateOverwritten: in cases where the due date is changed e.g. when payment is done prior to this due date, this field will be true.
originalDueDate: see above - the original due date is available from this field in case it’s overwritten.
paymentDate: the date of which the payment was done and the state is paid.
paymentMethod: a shallow object provided when the state of the bill is paid, containing id and type.
attachments: array of objects each containing a signed attachmentUrl, created and isOriginal fields.
notes: array of objects each containing value and created fields.
creditor: an object which may be provided, depending on the state of the bill (usually booked, awaiting, paid, duplicate and sometimes cancelled), containing just the id.
owner: an object which may be provided, depending on the way the bill was received - in such cases it will contain a shallow user object and may contain a shallow team object.
source: an object containing id and name of the API client.

\n","urlObject":{"path":["v2","expenses"],"host":["{{host}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"0cdc3aa7-aa1d-4891-96b6-d2fccdfee0fc"},{"name":"Generate","event":[{"listen":"test","script":{"id":"cb4c4086-f8a4-4f30-ba8d-3b32f49da56f","exec":["pm.test('status code is 200', function () {"," pm.response.to.have.status(200);","})"],"type":"text/javascript"}}],"id":"fc09062b-841f-4887-9a90-72e2a91f9cab","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{external-api-token}}"}]},"isInherited":false},"method":"POST","header":[{"warning":"This is a duplicate header and will be overridden by the Authorization header generated by Postman.","key":"Authorization","value":"Bearer {{access_token}}"},{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n\r\n\tteamId: {{teamId}}, // required\r\n\tinvoiceId: {{invoiceId}},\r\n\tfinancialDocumentType: {{financialDocumentType}}, // required\r\n\tamount: {{amount}}, // required\r\n\tdueDate: {{dueDate}}, // required\r\n\tissueDate: {{issueDate}}, // required\r\n\tmemo: {{memo}},\r\n\tcreditorName: {{creditorName}}, // required if vendorId not specified\r\n\tcreditorVAT: {{creditorVAT}},\r\n\tcurrency: {{currency}}, // required\r\n\tpaymentInstructions: {{paymentInstructions}},\r\n\tkeywords: {{keywords}},\r\n\tvendorId: {{vendorId}}, // required if it already exists in your vendor list\r\n\temail: {{email}}, // required only if the vendorId isn't passed in\r\n\tcountry: {{country_code}}, // required only if the vendorId isn't passed in\r\n\taddress: {\r\n address: {{address}}, \r\n postal: {{postal}}, \r\n city: {{city}}, \r\n stateProvince: {{stateProvince}}, \r\n country: {{country}}\r\n } // required only if the vendorId isn't passed in\r\n}"},"url":"{{host}}/v2/expenses/generate","description":"

⚠️ PREVIEW\nGenerate an expense.

Scopes: expenses.all (optional) and/or expenses.create.

Financial document types ({{financial_documentType}}): 0 for Bill, 1 for Receipt, 2 for Credit Note. The default is the Bill value.

\nExpense keywords ({{keywords}}): is an array of strings which can be used during approval workflow.

While generating an expense the payment instructions are required to be to include in the POST request payload. The following payment instructions are supported:\n

\nEmpty Payment instructions:

{\n    TransferType: 0\n}\n

\nAccount Transfer Payment instructions:

{\n    transferType: 1,\n    regNumber: {{reg_number}},\n    accountReference: {{account_reference}}\n}\n

\nFIK Transfer Payment instructions:

{\n    transferType: 2,\n    fikType: {{fik_type}}, // It is an int value\n    paymentReference: {{payment_reference}},\n    accountReference: {{account_reference}}\n}\n

\nIBAN Transfer Payment instructions:

{\n    transferType: 3,\n    IBAN: {{iban}},\n    SWIFT: {{swift}}\n}\n

\nACH Transfer Payment instructions:

{\n    TransferType: 4,\n    RoutingNumber: {{routingnumber}},\n    AccountNumber: {{accountnumber}},\n    AccountName: {{accountname}},\n    ACHRoutingEmail: {{email}}\n}\n

\nCheck Transfer Payment instructions:

{\n    TransferType: 5,\n    RemittanceName: {{name}},\n    Address1: {{address1}},\n    Address2: {{address2}},\n    City: {{city}},\n    ZipCode: {{zipcode}},\n    State: {{state}}\n}\n

On a successful request the endpoint will respond with 201 Created with a full expense payload:

id: the ID of the expense.
amount: the amount in smallest common currency unit i.e. cents, øre etc.
currency: the currency e.g. DKK, USD etc.
state: the state can be pending, booked, awaiting, paid, duplicate or cancelled.
referenceDate: timestamp for current state.
issueDate: available in state of booked, awaiting, paid, duplicate and sometimes cancelled.
dueDate: available in state of booked, awaiting, paid, duplicate and sometimes cancelled.
isDueDateOverwritten: in cases where the due date is changed e.g. when payment is done prior to this due date, this field will be true.
originalDueDate: see above - the original due date is available from this field in case it’s overwritten.
paymentDate: the date of which the payment was done and the state is paid.
paymentMethod: a shallow object provided when the state of the bill is paid, containing id and type.
attachments: array of objects each containing a signed attachmentUrl, created and isOriginal fields.
notes: array of objects each containing value and created fields.
creditor: an object which may be provided, depending on the state of the bill (usually booked, awaiting, paid, duplicate and sometimes cancelled), containing just the id.
owner: an object which may be provided, depending on the way the bill was received - in such cases it will contain a shallow user object and may contain a shallow team object.
source: an object containing id and name of the API client.

\n","urlObject":{"path":["v2","expenses","generate"],"host":["{{host}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"fc09062b-841f-4887-9a90-72e2a91f9cab"},{"name":"Approve","event":[{"listen":"test","script":{"id":"121f6281-6d59-4b4b-928c-f6e4cc4c32e0","exec":["pm.test('status code is 200', function () {"," pm.response.to.have.status(200);","})"],"type":"text/javascript"}}],"id":"fa40efaf-4d0d-4e1c-a3f2-2becc8ff6d2c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{external-api-token}}"}]},"isInherited":false},"method":"POST","header":[{"warning":"This is a duplicate header and will be overridden by the Authorization header generated by Postman.","key":"Authorization","value":"Bearer {{access_token}}"},{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/json"}],"url":"{{host}}/v2/expenses/approve","description":"

⚠️ PREVIEW\nApprove an expense waiting for approval.\nScopes: expenses.all (optional) and/or expenses.create.

\n","urlObject":{"path":["v2","expenses","approve"],"host":["{{host}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"fa40efaf-4d0d-4e1c-a3f2-2becc8ff6d2c"},{"name":"Decline","event":[{"listen":"test","script":{"id":"d09940ab-918f-4486-8ae6-39f12a27bf23","exec":["pm.test('status code is 200', function () {"," pm.response.to.have.status(200);","})"],"type":"text/javascript"}}],"id":"d8c8fac5-e8dc-4968-a53b-e02458f9a2b9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{external-api-token}}"}]},"isInherited":false},"method":"POST","header":[{"warning":"This is a duplicate header and will be overridden by the Authorization header generated by Postman.","key":"Authorization","value":"Bearer {{access_token}}"},{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n\tnote: {{note}}\r\n}"},"url":"{{host}}/v2/expenses/decline","description":"

⚠️ PREVIEW\nDecline an expense waiting for approval.\nScopes: expenses.all (optional) and/or expenses.create.\nA note as the reason for decline is mandatory

\n","urlObject":{"path":["v2","expenses","decline"],"host":["{{host}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"d8c8fac5-e8dc-4968-a53b-e02458f9a2b9"},{"name":"Get","id":"80707985-0c96-44fc-ae11-ab3e343748ab","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{external-api-token}}"}]},"isInherited":false},"method":"GET","header":[{"warning":"This is a duplicate header and will be overridden by the Authorization header generated by Postman.","key":"Authorization","value":"Bearer {{access_token}}"}],"url":"{{host}}/v2/expenses/{{expense_id}}","description":"

⚠️ PREVIEW

View/read an expense.

Scopes: expenses.all (optional) and/or expenses.read.

On a successful request the endpoint will respond with 200 OK with a full bill payload:

id: the ID of the expense.
amount: the amount in smallest common currency unit i.e. cents, øre etc.
currency: the currency e.g. DKK, USD etc.
state: the state can be pending, booked, awaiting, paid, duplicate or cancelled.
referenceDate: timestamp for current state.
issueDate: available in state of booked, awaiting, paid, duplicate and sometimes cancelled.
dueDate: available in state of booked, awaiting, paid, duplicate and sometimes cancelled.
isDueDateOverwritten: in cases where the due date is changed e.g. when payment is done prior to this due date, this field will be true.
originalDueDate: see above - the original due date is available from this field in case it’s overwritten.
paymentDate: the date of which the payment was done and the state is paid.
paymentMethod: a shallow object provided when the state of the bill is paid, containing id and type.
attachments: array of objects each containing a signed attachmentUrl, created and isOriginal fields.
notes: array of objects each containing value and created fields.
creditor: an object which may be provided, depending on the state of the bill (usually booked, awaiting, paid, duplicate and sometimes cancelled), containing just the id.
owner: an object which may be provided, depending on the way the bill was received - in such cases it will contain a shallow user object and may contain a shallow team object.
source: an object containing id and name of the API client.
declineReason: a string containing the reason why the expense has been declined.

\n","urlObject":{"path":["v2","expenses","{{expense_id}}"],"host":["{{host}}"],"query":[],"variable":[]}},"response":[{"id":"1a01d7c7-8342-4d6e-9910-fa2a78cc5c46","name":"Read","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer {{access_token}}"}],"body":{"mode":"formdata","formdata":[]},"url":"{{host}}/v1/bills/{{bill_id}}"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"expense\": {\n \"id\": \"M6gdyLr3\",\n \"type\": \"bill\",\n \"reference\": \"14227295\",\n \"number\": 2,\n \"amount\": 96793,\n \"currency\": \"USD\",\n \"state\": \"awaiting\",\n \"referenceDate\": \"2022-03-19T00:00:00Z\",\n \"issueDate\": \"2020-12-15T00:00:00Z\",\n \"dueDate\": \"2022-03-19T00:00:00Z\",\n \"attachments\": [\n {\n \"id\": \"a1LepgbG\",\n \"url\": \"https://attachments...\",\n \"created\": \"2021-01-14T11:24:02Z\",\n \"isOriginal\": true\n }\n ],\n \"notes\": [\n {\n \"id\": \"wXLJnLWy\",\n \"value\": \"note3\",\n \"created\": \"2021-01-14T11:24:24Z\"\n }\n ],\n \"category\": {\n \"id\": \"2ymnkg9O\",\n \"name\": \"Salg af ydelser til udland(UpdatedSecond)\",\n \"number\": \"1021\"\n },\n \"departments\": [\n {\n \"externalId\": \"2\",\n \"id\": \"4em12gxk\",\n \"name\": \"2 B2B\",\n \"color\": \"\",\n \"created\": \"2021-01-14T10:33:36Z\"\n }\n ],\n \"isPayable\": true,\n \"labels\": [\n {\n \"id\": \"M6gdyLr3\",\n \"value\": \"2 Projekt NYC\",\n \"listId\": \"74mjYBn0\",\n \"externalId\": \"2\"\n },\n {\n \"id\": \"nAmYGLaX\",\n \"value\": \"1 TestCostType\",\n \"listId\": \"4em12gxk\",\n \"externalId\": \"1\"\n },\n {\n \"id\": \"kyB3pmMr\",\n \"value\": \"B25 - Byggeydelser udland\",\n \"listId\": \"5ELZjL4K\",\n \"externalId\": \"B25\"\n }\n ],\n \"creditor\": {\n \"id\": \"M6gdyLr3\"\n },\n \"owner\": {\n \"user\": {\n \"id\": \"a1LepgbG\"\n },\n \"team\": {\n \"id\": \"5ELZjL4K\"\n }\n }\n }\n }\n}"}],"_postman_id":"80707985-0c96-44fc-ae11-ab3e343748ab"},{"name":"Get Activities","id":"88aeb16c-2652-48cf-a238-8ce47ee95561","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{external-api-token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Authorization","value":"Bearer {{access_token}}","warning":"This is a duplicate header and will be overridden by the Authorization header generated by Postman."}],"url":"{{host}}/v2/expenses/{{expense_id}}/activities","description":"

View/read an expense activities.

Scopes: expenses.all (optional) or expenses.read.

On a successful request the endpoint will respond with 200 OK with a list of activities with the payload:

activityType the type of activtity can be message, timeLineEvent
body: the body of the activity
userId: user who has performed the activity.
created: the date when the activity was created

\n","urlObject":{"path":["v2","expenses","{{expense_id}}","activities"],"host":["{{host}}"],"query":[],"variable":[]}},"response":[{"id":"50530d39-fe96-476c-9a52-ba03a612b122","name":"Read","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer {{access_token}}"}],"body":{"mode":"formdata","formdata":[]},"url":"{{host}}/v1/bills/{{bill_id}}"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"bill\": {\n \"id\": \"{{bill_id}}\",\n \"amount\": 12345,\n \"currency\": \"DKK\",\n \"state\": \"paid\",\n \"referenceDate\": \"ISO 8601 Date\",\n \"issueDate\": \"ISO 8601 Date\",\n \"dueDate\": \"ISO 8601 Date\",\n \"isDueDateOverwritten\": false,\n \"paymentDate\": \"ISO 8601 Date\",\n \"paymentMethod\": {\n \t\"id\": \"{{card_id}}\",\n \t\"type\": \"PaymentCard\"\n },\n \"attachments\": [\n {\n \"attachmentUrl\": \"https://....\",\n \"created\": \"ISO 8601 Date\",\n \"isOriginal\": true\n }\n ],\n \"notes\": [\n {\n \"value\": \"Some text...\",\n \"created\": \"ISO 8601 Date\"\n }\n ],\n \"creditor\": {\n \"id\": \"{{creditor_id}}\"\n },\n \"owner\": {\n \"user\": {\n \"id\": \"{{user_id}}\"\n },\n \"team\": {\n \"id\": \"{{team_id}}\"\n }\n },\n \"source\": {\n \"id\": \"{{source_id}}\",\n \"name\": \"Partner\"\n }\n }\n }\n}"}],"_postman_id":"88aeb16c-2652-48cf-a238-8ce47ee95561"},{"name":"Post Activities","id":"df7a6239-2174-4a50-bc79-5010653ef750","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{external-api-token}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Authorization","value":"Bearer {{access_token}}","warning":"This is a duplicate header and will be overridden by the Authorization header generated by Postman."}],"body":{"mode":"urlencoded","urlencoded":[{"description":"

Required body of the message e.g. @User Testaccount Be Awesome!!!

\n","key":"body","type":"text","value":"{{body}}"},{"description":"

Required type of message 0 for Text, 1 for StandaloneEmoji

\n","key":"type","type":"text","value":"{{type}}"},{"description":"

Optional parrent message id, e.g an Emoji should be attached to a specific message id

\n","key":"parentId","type":"text","value":"{{parentId}}"}]},"url":"{{host}}/v2/expenses/{{expense_id}}/activities","description":"

Create an expense activity (message).

Scopes: expenses.all (optional) or expenses.create.

On a successful request the endpoint will respond with 201 Created with the created message id.

\n","urlObject":{"path":["v2","expenses","{{expense_id}}","activities"],"host":["{{host}}"],"query":[],"variable":[]}},"response":[{"id":"84decf52-8bca-4d4f-8188-0c2234eac52b","name":"Read","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer {{access_token}}"}],"body":{"mode":"formdata","formdata":[]},"url":"{{host}}/v1/bills/{{bill_id}}"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"bill\": {\n \"id\": \"{{bill_id}}\",\n \"amount\": 12345,\n \"currency\": \"DKK\",\n \"state\": \"paid\",\n \"referenceDate\": \"ISO 8601 Date\",\n \"issueDate\": \"ISO 8601 Date\",\n \"dueDate\": \"ISO 8601 Date\",\n \"isDueDateOverwritten\": false,\n \"paymentDate\": \"ISO 8601 Date\",\n \"paymentMethod\": {\n \t\"id\": \"{{card_id}}\",\n \t\"type\": \"PaymentCard\"\n },\n \"attachments\": [\n {\n \"attachmentUrl\": \"https://....\",\n \"created\": \"ISO 8601 Date\",\n \"isOriginal\": true\n }\n ],\n \"notes\": [\n {\n \"value\": \"Some text...\",\n \"created\": \"ISO 8601 Date\"\n }\n ],\n \"creditor\": {\n \"id\": \"{{creditor_id}}\"\n },\n \"owner\": {\n \"user\": {\n \"id\": \"{{user_id}}\"\n },\n \"team\": {\n \"id\": \"{{team_id}}\"\n }\n },\n \"source\": {\n \"id\": \"{{source_id}}\",\n \"name\": \"Partner\"\n }\n }\n }\n}"}],"_postman_id":"df7a6239-2174-4a50-bc79-5010653ef750"},{"name":"Delete","id":"48e73ec1-6ade-449b-8be5-64b9f20d4444","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{external-api-token}}"}]},"isInherited":false},"method":"DELETE","header":[{"warning":"This is a duplicate header and will be overridden by the Authorization header generated by Postman.","key":"Authorization","value":"Bearer {{access_token}}"}],"url":"{{host}}/v2/expenses/{{expense_id}}","description":"

⚠️ PREVIEW

Delete an expense.

Scopes: expenses.all (optional) and/or expenses.delete.

On a successful request the endpoint will respond with 200 OK.

\n","urlObject":{"path":["v2","expenses","{{expense_id}}"],"host":["{{host}}"],"query":[],"variable":[]}},"response":[{"id":"b23807ae-8de5-46ea-a9a7-4ddf972117f2","name":"Read","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer {{access_token}}"}],"body":{"mode":"formdata","formdata":[]},"url":"{{host}}/v1/bills/{{bill_id}}"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"bill\": {\n \"id\": \"{{bill_id}}\",\n \"amount\": 12345,\n \"currency\": \"DKK\",\n \"state\": \"paid\",\n \"referenceDate\": \"ISO 8601 Date\",\n \"issueDate\": \"ISO 8601 Date\",\n \"dueDate\": \"ISO 8601 Date\",\n \"isDueDateOverwritten\": false,\n \"paymentDate\": \"ISO 8601 Date\",\n \"paymentMethod\": {\n \t\"id\": \"{{card_id}}\",\n \t\"type\": \"PaymentCard\"\n },\n \"attachments\": [\n {\n \"attachmentUrl\": \"https://....\",\n \"created\": \"ISO 8601 Date\",\n \"isOriginal\": true\n }\n ],\n \"notes\": [\n {\n \"value\": \"Some text...\",\n \"created\": \"ISO 8601 Date\"\n }\n ],\n \"creditor\": {\n \"id\": \"{{creditor_id}}\"\n },\n \"owner\": {\n \"user\": {\n \"id\": \"{{user_id}}\"\n },\n \"team\": {\n \"id\": \"{{team_id}}\"\n }\n },\n \"source\": {\n \"id\": \"{{source_id}}\",\n \"name\": \"Partner\"\n }\n }\n }\n}"}],"_postman_id":"48e73ec1-6ade-449b-8be5-64b9f20d4444"},{"name":"List","id":"4ad9a666-1526-4452-a5e2-ebbd86d741ab","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{external-api-token}}"}]},"isInherited":false},"method":"GET","header":[{"warning":"This is a duplicate header and will be overridden by the Authorization header generated by Postman.","key":"Authorization","value":"Bearer {{access_token}}"},{"key":"Content-Type","name":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"}],"body":{"mode":"formdata","formdata":[]},"url":"{{host}}/v2/expenses?teamId={{team_id}}&offset={{offset}}&count={{count}}&type={{type}}&state={{state}}","description":"

⚠️ PREVIEW

Get/list expenses.

Scopes: expenses.all (optional) and/or expenses.list.

On a successful request the endpoint will respond with 200 OK with a shallow list of expenses.

\n","urlObject":{"path":["v2","expenses"],"host":["{{host}}"],"query":[{"description":{"content":"

Required field

\n","type":"text/plain"},"key":"teamId","value":"{{team_id}}"},{"description":{"content":"

Optional.

\n","type":"text/plain"},"key":"offset","value":"{{offset}}"},{"description":{"content":"

Optional.

\n","type":"text/plain"},"key":"count","value":"{{count}}"},{"description":{"content":"

Optional. \nFinancial document types ({{type}}): 0 for Bill, 1 for Receipt, 2 for Credit Note. If not specified all document types will be included.

\n","type":"text/plain"},"key":"type","value":"{{type}}"},{"description":{"content":"

Optional. \nBill state ({{state}}): 0 for Pending,1 for Booked,2 for Paid,4 for Cancelled,5 for Awaiting,6 for Paused,7 for Duplicate,8 for Refunded,9 for Initialized

\n","type":"text/plain"},"key":"state","value":"{{state}}"}],"variable":[]}},"response":[{"id":"99a26510-87fe-4119-966d-f85eb6453b19","name":"List","originalRequest":{"method":"GET","header":[{"warning":"This is a duplicate header and will be overridden by the Authorization header generated by Postman.","key":"Authorization","value":"Bearer {{access_token}}"},{"key":"Content-Type","name":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"}],"body":{"mode":"formdata","formdata":[]},"url":{"raw":"{{host}}/v2/expenses?teamId={{team_id}}&offset={{offset}}&count={{count}}&type={{type}}&state={{state}}","host":["{{host}}"],"path":["v2","expenses"],"query":[{"key":"teamId","value":"{{team_id}}","description":"Required field"},{"key":"offset","value":"{{offset}}","description":"*Optional.*"},{"key":"count","value":"{{count}}","description":"*Optional.*"},{"key":"type","value":"{{type}}","description":"*Optional.* \nFinancial document types (`{{type}}`): `0` for Bill, `1` for Receipt, `2` for Credit Note. If not specified all document types will be included.\n"},{"key":"state","value":"{{state}}","description":"*Optional.* \nBill state (`{{state}}`): `0` for Pending,`1` for Booked,`2` for Paid,`4` for Cancelled,`5` for Awaiting,`6` for Paused,`7` for Duplicate,`8` for Refunded,`9` for Initialized\n"}]}},"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":"{\r\n \"total\": 2,\r\n \"offset\": 0,\r\n \"count\": 2,\r\n \"data\": {\r\n \"bills\": [\r\n {\r\n \"id\": \"M6gdyLr3\",\r\n \"number\": 2,\r\n \"amount\": 96793,\r\n \"currency\": \"USD\",\r\n \"state\": \"awaiting\",\r\n \"referenceDate\": \"2022-03-19T00:00:00Z\",\r\n \"issueDate\": \"2020-12-15T00:00:00Z\",\r\n \"dueDate\": \"2022-03-19T00:00:00Z\",\r\n \"isDueDateOverwritten\": false,\r\n \"category\": {\r\n \"id\": \"2ymnkg9O\"\r\n },\r\n \"vendor\": {\r\n \"id\": \"M6gdyLr3\"\r\n },\r\n \"owner\": {\r\n \"user\": {\r\n \"id\": \"a1LepgbG\"\r\n },\r\n \"team\": {\r\n \"id\": \"5ELZjL4K\"\r\n }\r\n },\r\n \"type\": \"bill\"\r\n },\r\n {\r\n \"id\": \"wXLJnLWy\",\r\n \"number\": 1,\r\n \"amount\": 21488,\r\n \"currency\": \"USD\",\r\n \"state\": \"awaiting\",\r\n \"referenceDate\": \"2022-06-25T00:00:00Z\",\r\n \"issueDate\": \"2020-12-15T00:00:00Z\",\r\n \"dueDate\": \"2022-06-25T00:00:00Z\",\r\n \"isDueDateOverwritten\": false,\r\n \"category\": {\r\n \"id\": \"2ymnkg9O\"\r\n },\r\n \"vendor\": {\r\n \"id\": \"wXLJnLWy\"\r\n },\r\n \"owner\": {\r\n \"user\": {\r\n \"id\": \"a1LepgbG\"\r\n },\r\n \"team\": {\r\n \"id\": \"5ELZjL4K\"\r\n }\r\n },\r\n \"type\": \"bill\"\r\n }\r\n ]\r\n }\r\n}"}],"_postman_id":"4ad9a666-1526-4452-a5e2-ebbd86d741ab"},{"name":"Attachments","id":"3a00162f-edc8-45eb-be5d-7414afe54b65","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{external-api-token}}"}]},"isInherited":false},"method":"POST","header":[{"warning":"This is a duplicate header and will be overridden by the Authorization header generated by Postman.","key":"Authorization","value":"Bearer {{access_token}}"},{"key":"Content-Type","type":"text","value":"multipart/form-data"}],"body":{"mode":"formdata","formdata":[{"description":"

Supported formats \"pdf\", \"png\", \"jpeg\", \"bmp\", \"tiff\"

\n","key":"files","type":"file","value":null},{"key":"replaceMainAttachment","value":"","description":"

optional

\n","type":"text"},{"key":"generateUnifiedAttachment","value":"","description":"

optional If true will combine all the attachments into a single PDF

\n","type":"text"}]},"url":"{{host}}/v2/expenses/{{expense_id}}/attachments","description":"

Attach a document to an expense.

Scopes: expenses.all (optional) and/or expenses.create.

\nSupported formats: pdf, png, jpeg, bmp, tiff, xml.

\nOn a successful request the endpoint will respond with 201 Created.

\n","urlObject":{"path":["v2","expenses","{{expense_id}}","attachments"],"host":["{{host}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"3a00162f-edc8-45eb-be5d-7414afe54b65"},{"name":"Labels","id":"d332b3a7-aadd-48a1-81a3-6d52371380f9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{external-api-token}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Authorization","value":"Bearer {{access_token}}","warning":"This is a duplicate header and will be overridden by the Authorization header generated by Postman."},{"key":"Content-Type","type":"text","value":"multipart/form-data"}],"body":{"mode":"formdata","formdata":[{"description":"

Required

\n","key":"labelId","type":"text","value":""}]},"url":"{{host}}/v2/expenses/{{expense_id}}/labels","description":"

Set a label on an expense.

Scopes: expenses.all (optional) and/or expenses.create.

\nOn a successful request the endpoint will respond with 200 OK.

\n","urlObject":{"path":["v2","expenses","{{expense_id}}","labels"],"host":["{{host}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"d332b3a7-aadd-48a1-81a3-6d52371380f9"},{"name":"Amountlines","id":"be3869aa-b497-406a-a924-de26b24b3024","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{external-api-token}}"}]},"isInherited":false},"method":"GET","header":[],"url":"{{host}}/v2/expenses/{{expense_id}}/amountlines","description":"

View/read an expense amount lines.

Scopes: expenses.all (optional) and/or expenses.read.

On a successful request the endpoint will respond with 200 OK with a full list of expense amount lines

\n","urlObject":{"path":["v2","expenses","{{expense_id}}","amountlines"],"host":["{{host}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"be3869aa-b497-406a-a924-de26b24b3024"}],"id":"4f536930-c542-429f-a17f-d23a9ad99c8c","description":"

Handling of expenses. It's currently possible to upload, generate new expenses also view (read) existing expenses of users created by the same API client.

Available scopes: expenses.all, expenses.create, expenses.read and expenses.list.

\n","event":[{"listen":"prerequest","script":{"id":"c700afb5-c6cd-4a60-809e-75f9921c3c43","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"26fd7161-18eb-487d-900a-30685391aa8a","type":"text/javascript","exec":[""]}}],"_postman_id":"4f536930-c542-429f-a17f-d23a9ad99c8c","auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"d1926441-fcff-43b1-907a-1a240d7eefbc","id":"d1926441-fcff-43b1-907a-1a240d7eefbc","name":"Roger API (Roger.ai)","type":"collection"}}},{"name":"Webhooks","item":[{"name":"Create","id":"442f3d4c-8d03-41b1-a3a8-7e1ce09a66bb","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{external-api-token}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Authorization","value":"Bearer {{access_token}}"},{"key":"Content-Type","value":"application/x-www-form-urlencoded","description":"

application/json is also supported.

\n"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"url","value":"https://example.com/webhook","type":"text"},{"key":"events","value":"bill.state.booked,bill.state.paid,bill.state.refunded,paymentmethod.created,paymentmethod.deleted","type":"text","description":"

If using application/json, this needs to be provided as an array of strings.

\n"},{"key":"teamId","value":"{{team_id}}","description":"

Optional. Will be created for user-related events if left out.

\n","type":"text"}]},"url":"{{host}}/v1/webhooks","description":"

⚠️ PREVIEW\nAdd/create webhooks.

Scopes: webhooks.all (optional) and/or webhooks.create.

The endpoint will respond with 201 Created on a successful request. The Location header contains the API location of the newly created entity (WIP).

While validating the supplied URL, a POST request with the following payload (prettified for clarity) will be sent:\n

{\n  \"data\": {\n    \"event\": \"webhook.validation\",\n    \"timestamp\": \"2017-07-27T21:46:00.0800000Z\"\n  }\n}\n

The supplied URL must respond with 200 OK for the webhook to be saved correctly (any payload will be ignored).

\n","urlObject":{"path":["v1","webhooks"],"host":["{{host}}"],"query":[],"variable":[]}},"response":[{"id":"0fe1b1d8-8ae0-4233-abda-9c719dad1c3d","name":"Create","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"Bearer {{access_token}}"},{"key":"Content-Type","value":"application/x-www-form-urlencoded","description":"`application/json` is also supported."}],"body":{"mode":"urlencoded","urlencoded":[{"key":"url","value":"{{webhook_url}}","type":"text"},{"key":"events","value":"bill.state.booked,bill.state.paid,bill.state.refunded,paymentmethod.created,paymentmethod.deleted","type":"text","description":"If using `application/json`, this needs to be provided as an array of strings."},{"key":"teamId","value":"{{team_id}}","description":"*Optional.* Will be created for user-related events if left out.","type":"text"}]},"url":"{{host}}/v1/webhooks"},"status":"Created","code":201,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"private","name":"Cache-Control","description":""},{"key":"Connection","value":"keep-alive","name":"Connection","description":""},{"key":"Content-Type","value":"application/json; charset=utf-8","name":"Content-Type","description":""},{"key":"Date","value":"Mon, 19 Mar 2018 09:33:25 GMT","name":"Date","description":""},{"key":"Link","value":"; rel=\"application/xml\"","name":"Link","description":""},{"key":"Location","value":"/v1/webhooks/Q6LlRmao","name":"Location","description":""},{"key":"Server","value":"Microsoft-IIS/10.0","name":"Server","description":""},{"key":"Vary","value":"Accept","name":"Vary","description":""},{"key":"transfer-encoding","value":"chunked","name":"transfer-encoding","description":""}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"webhook\": {\n \"id\": \"{{webhook_id}}\",\n \"url\": \"{{webhook_url}}\",\n \"events\": [\n \"bill.state.booked\",\n \"bill.state.paid\",\n \"bill.state.refunded\",\n \"paymentmethod.created\",\n \"paymentmethod.deleted\"\n ],\n \"source\": {\n \"id\": \"{{apiclient_id}}\",\n \"name\": \"{{apiclient_name}}\"\n }\n }\n }\n}"}],"_postman_id":"442f3d4c-8d03-41b1-a3a8-7e1ce09a66bb"},{"name":"Read","id":"4adde9ef-219c-47ae-9024-4a0b1e662d2c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{external-api-token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Authorization","value":"Bearer {{access_token}}"}],"url":"{{host}}/v1/webhooks/{{webhook_id}}","description":"

⚠️ PREVIEW

Get/read a specific webhook created by the authenticated user (only by this API client/consumer).

Scopes: webhooks.all (optional) and/or webhooks.read.

The endpoint will respond with 200 OK on a successful request.

\n","urlObject":{"path":["v1","webhooks","{{webhook_id}}"],"host":["{{host}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"4adde9ef-219c-47ae-9024-4a0b1e662d2c"},{"name":"Delete","id":"93171437-cdb4-41a5-92fc-18a81a219e7f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{external-api-token}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Authorization","value":"Bearer {{access_token}}"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"{{host}}/v1/webhooks/{{webhook_id}}","description":"

⚠️ PREVIEW\nRemove/delete webhooks.

Scopes: webhooks.all (optional) and/or webhooks.delete.

The endpoint will respond with 200 OK on a successful request.

\n","urlObject":{"path":["v1","webhooks","{{webhook_id}}"],"host":["{{host}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"93171437-cdb4-41a5-92fc-18a81a219e7f"},{"name":"List","id":"872ebae3-e832-479c-bbcd-bdd5d0f15e8a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{external-api-token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Authorization","value":"Bearer {{access_token}}"}],"url":"{{host}}/v1/webhooks?teamId={{teamId}}","description":"

⚠️ PREVIEW

Get/list webhooks created by the authenticated user (only by this API client/consumer).

Scopes: webhooks.all (optional) and/or webhooks.list.

The endpoint will respond with 201 OK on a successful request.

\n","urlObject":{"path":["","v1","webhooks"],"host":["{{host}}"],"query":[{"key":"teamId","value":"{{teamId}}"}],"variable":[]}},"response":[],"_postman_id":"872ebae3-e832-479c-bbcd-bdd5d0f15e8a"}],"id":"3612df47-9266-4917-825a-8e157d39dc51","description":"

Subscribe or unsubscribe to events with webhooks.

All expenses on the Roger platform are treated as an abstract mathematical model known as a finite-state machine (FSM). The dominating property is that any expense can only be in exactly one of the finite number of states at any given time. By abstracting the actual lifetime of an expense as a FSM we simply the calculation and look-up operations on any given expense at anytime. The event in this context is describing the overall status of the expense, wether a expense is analyzing, booked, paid etc. The state machine is designed to remember preceding events and called the state of the system.

\n\n\n

Events

We currently support the following events: expense.state.pending, expense.state.booked, expense.state.paid, expense.state.refunded, expense.state.cancelled, expense.approval.declined, expense.state.paused, expense.state.duplicate, paymentmethod.created, paymentmethod.deleted, team.category.update, team.department.update, team.list.update, expense.vendor.updated, team.vendor.updated, and team.vendor.added.

Payload example for Event `expense.state.paid`:

{\n  \"data\": {\n    \"event\": \"expense.state.paid\",\n    \"timestamp\": \"2017-06-26T20:45:00.0700000Z\",\n    \"bill\": {\n      \"id\": \"{{expense_id}}\",\n      \"state\": \"{{expense_state}}\"\n    }\n  }\n}\n

\n\n

Issue a GET request to {{host}}/v2/expenses/{{expense_id}} to get the full expense object.\n

Security

A X-Roger-Signature header is added to all requests originating from our services. This prevents malicious third-parties from forging requests, and we therefore highly recommend you to validate the request signature. Signatures are generated using a hash-based message authentication code (HMAC) with SHA-512.

A value of a header should have the following format: t={{epoch_timestamp}};v1={{signed_hash}}. To validate the signature, please follow the steps below:

Extract the timestamp (epoch_timestamp) from t and the value (signed_hash) for v1 for comparison.
Prepare your own signed hash (own_signed_hash) by concatenating epoch_timestamp (as a string), a dot (the character .) and the actual JSON payload (the request body).
Compute HMAC with the SHA-512 hash function using your separate webhook secret as the key and concatenated string from the previous step as the message.
Compare signed_hash from the request header to own_signed_hash, which you've just computed. If the signatures match, compute the difference between the current timestamp and the received timestamp (epoch_timestamp), then decide if the difference is within your tolerance.

\n","event":[{"listen":"prerequest","script":{"id":"9afbbf78-0d9d-4f2e-9717-70c1881a4c6b","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"4f390c67-340a-4f6f-b3aa-f7a9162f1785","type":"text/javascript","exec":[""]}}],"_postman_id":"3612df47-9266-4917-825a-8e157d39dc51","auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"d1926441-fcff-43b1-907a-1a240d7eefbc","id":"d1926441-fcff-43b1-907a-1a240d7eefbc","name":"Roger API (Roger.ai)","type":"collection"}}},{"name":"Health","item":[{"name":"Ping","event":[{"listen":"test","script":{"id":"2c456d7a-2e60-46c7-991d-65161f797d45","type":"text/javascript","exec":["pm.test('status is 200', function() {"," pm.response.to.have.status(200);","});","","pm.test('ping to pong', function() {"," pm.response.to.have.body('pong');","});"]}}],"id":"a97678cd-d26c-420b-a74a-b628332d86b0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[],"url":"{{host}}/v1/health/ping","description":"

Will return 200 OK with a body of pong.

\n","urlObject":{"path":["v1","health","ping"],"host":["{{host}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"a97678cd-d26c-420b-a74a-b628332d86b0"},{"name":"Info","event":[{"listen":"test","script":{"id":"0d3fec5c-8c7c-4432-bd1d-98bbad8f0eeb","exec":["var data = JSON.parse(responseBody);","postman.setGlobalVariable(\"external-api-token\", data.access_token);"],"type":"text/javascript"}}],"id":"1d140f3d-9b3e-4f91-be83-5be274a27a0f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[],"url":"{{host}}/v1/health/info","description":"

Will return various information about the current environment etc.

\n","urlObject":{"path":["v1","health","info"],"host":["{{host}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"1d140f3d-9b3e-4f91-be83-5be274a27a0f"}],"id":"4133155c-8534-4ca1-bfb2-3f17a9f99f4a","_postman_id":"4133155c-8534-4ca1-bfb2-3f17a9f99f4a","description":"","auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"d1926441-fcff-43b1-907a-1a240d7eefbc","id":"d1926441-fcff-43b1-907a-1a240d7eefbc","name":"Roger API (Roger.ai)","type":"collection"}}},{"name":"Users","item":[{"name":"Me","id":"07effb6e-1ca5-4588-ac87-bd5e032279e1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{external-api-token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Authorization","value":"Bearer {{access_token}}"}],"url":"{{host}}/v1/users/me","description":"

View/read the current authenticated user.

🚩 Support for retrieving/reading team members is in development.

Scopes: users.all (optional) and/or users.read.

The endpoint will respond with 200 OK on a successful request.

\n","urlObject":{"path":["v1","users","me"],"host":["{{host}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"07effb6e-1ca5-4588-ac87-bd5e032279e1"}],"id":"d773653f-7a2c-4ac0-8b49-b8703e5f2f0f","description":"

Handling of users. It's currently only possible to get (read) the current user, as well as adding (create) new users (available for selected partners).

Available scopes: users.all, users.create, users.read and users.update.

\n","event":[{"listen":"prerequest","script":{"id":"921b09fc-6618-4d6f-93f3-314dc63c42a8","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"c7f639ef-f98e-465b-be85-8390433c8caf","type":"text/javascript","exec":[""]}}],"_postman_id":"d773653f-7a2c-4ac0-8b49-b8703e5f2f0f","auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"d1926441-fcff-43b1-907a-1a240d7eefbc","id":"d1926441-fcff-43b1-907a-1a240d7eefbc","name":"Roger API (Roger.ai)","type":"collection"}}},{"name":"Teams","item":[{"name":"General","item":[{"name":"Create","id":"938e9e9a-18df-4601-a4ad-fb795c8fff2e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{external-api-token}}"}]},"isInherited":false},"method":"POST","header":[{"warning":"This is a duplicate header and will be overridden by the Authorization header generated by Postman.","key":"Authorization","value":"Bearer {{access_token}}"},{"key":"Content-Type","value":"application/x-www-form-urlencoded","description":"

application/json is also supported.

\n"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"name","value":"{{team_name}}","type":"text","description":"

Team name e.g. your company's name.

\n"},{"key":"country","value":"{{team_country}}","description":"

Team country e.g. dk, us

\n","type":"text"},{"key":"vat","value":"{{team_vat}}","type":"text"}]},"url":"{{host}}/v1/teams","description":"

Add/create teams.

Scopes: teams.all (optional) and/or teams.create.

The endpoint will respond with 201 Created on a successful request. The Location header contains the API location of the newly created entity.

\n","urlObject":{"path":["v1","teams"],"host":["{{host}}"],"query":[],"variable":[]}},"response":[{"id":"7a8c4935-efdc-46a2-aec5-f91fed6e4fa8","name":"Create","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"Bearer {{access_token}}"},{"key":"Content-Type","value":"application/x-www-form-urlencoded","description":"`application/json` is also supported."}],"body":{"mode":"urlencoded","urlencoded":[{"key":"name","value":"{{team_name}}","type":"text","description":"Team name e.g. your company's name."}]},"url":"{{host}}/v1/teams"},"status":"Created","code":201,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"private","name":"Cache-Control","description":""},{"key":"Connection","value":"keep-alive","name":"Connection","description":""},{"key":"Content-Type","value":"application/json; charset=utf-8","name":"Content-Type","description":""},{"key":"Date","value":"Mon, 19 Mar 2018 09:32:52 GMT","name":"Date","description":""},{"key":"Link","value":"; rel=\"application/xml\"","name":"Link","description":""},{"key":"Location","value":"/v1/teams/nzBW3OBb","name":"Location","description":""},{"key":"Vary","value":"Accept","name":"Vary","description":""},{"key":"transfer-encoding","value":"chunked","name":"transfer-encoding","description":""}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"team\": {\n \"id\": \"{{team_id}}\",\n \"name\": \"{{team_name}}\",\n \"rogerAddress\": \"generated-handle@pay.roger.ai\",\n \"owner\": {\n \"id\": \"{{user_id}}\"\n },\n \"source\": {\n \"id\": \"{{apiclient_id}}\",\n \"name\": \"{{apiclient_name}}\"\n }\n }\n }\n}"}],"_postman_id":"938e9e9a-18df-4601-a4ad-fb795c8fff2e"},{"name":"Read","id":"672a65c4-a565-429e-aaf9-f5bd1d8f7ed9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{external-api-token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Authorization","value":"Bearer {{access_token}}"}],"url":"{{host}}/v1/teams/{{team_id}}","description":"

View/read a team (where authenticated user must be a member).

Scopes: teams.all (optional) and/or teams.read.

The endpoint will respond with 200 OK on a successful request.

\n","urlObject":{"path":["v1","teams","{{team_id}}"],"host":["{{host}}"],"query":[],"variable":[]}},"response":[{"id":"b0e5b3a5-3ad1-4ef8-a289-abf32846f262","name":"Read","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer {{access_token}}"}],"body":{"mode":"formdata","formdata":[]},"url":"{{host}}/v1/teams/{{team_id}}"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"private","name":"Cache-Control","description":""},{"key":"Connection","value":"keep-alive","name":"Connection","description":""},{"key":"Content-Type","value":"application/json; charset=utf-8","name":"Content-Type","description":""},{"key":"Date","value":"Mon, 19 Mar 2018 09:20:16 GMT","name":"Date","description":""},{"key":"Link","value":"; rel=\"application/xml\"","name":"Link","description":""},{"key":"Server","value":"Microsoft-IIS/10.0","name":"Server","description":""},{"key":"Vary","value":"Accept","name":"Vary","description":""},{"key":"transfer-encoding","value":"chunked","name":"transfer-encoding","description":""}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"team\": {\n \"id\": \"{{team_id}}\",\n \"name\": \"{{team_name}}\",\n \"rogerAddress\": \"generated-handle@pay.roger.ai\",\n \"owner\": {\n \"id\": \"{{user_id}}\"\n }\n }\n }\n}"}],"_postman_id":"672a65c4-a565-429e-aaf9-f5bd1d8f7ed9"},{"name":"List","id":"c916317a-c972-4d9b-b51b-28cc9a0239bd","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{external-api-token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Authorization","value":"Bearer {{access_token}}"}],"url":"{{host}}/v1/teams","description":"

Get/list teams of the authenticated user.

Scopes: teams.all (optional) and/or teams.list.

The endpoint will respond with 200 OK on a successful request.

\n","urlObject":{"path":["v1","teams"],"host":["{{host}}"],"query":[],"variable":[]}},"response":[{"id":"fc3136f5-e1a7-4108-97e3-2dcfbce85f17","name":"List","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer {{access_token}}","warning":"This is a duplicate header and will be overridden by the Authorization header generated by Postman."}],"body":{"mode":"formdata","formdata":[]},"url":"{{host}}/v1/teams"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"private","name":"Cache-Control","description":""},{"key":"Connection","value":"keep-alive","name":"Connection","description":""},{"key":"Content-Length","value":"21","name":"Content-Length","description":""},{"key":"Content-Type","value":"application/json; charset=utf-8","name":"Content-Type","description":""},{"key":"Date","value":"Mon, 19 Mar 2018 09:32:36 GMT","name":"Date","description":""},{"key":"Link","value":"; rel=\"application/xml\"","name":"Link","description":""},{"key":"Server","value":"Microsoft-IIS/10.0","name":"Server","description":""},{"key":"Vary","value":"Accept","name":"Vary","description":""}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"teams\": [\n {\n \"name\": \"Company1\",\n \"vat\": \"\",\n \"id\": \"wXLJnLWy\"\n },\n {\n \"name\": \"Company2\",\n \"vat\": \"\",\n \"id\": \"5ELZjL4K\"\n }\n ]\n }\n}"}],"_postman_id":"c916317a-c972-4d9b-b51b-28cc9a0239bd"},{"name":"Delete","id":"e02c197c-4844-4abc-8006-41f92b204912","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{external-api-token}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Authorization","value":"Bearer {{access_token}}"}],"url":"{{host}}/v1/teams/{{team_id}}","description":"

Delete a team (where authenticated user must be a member).

Scopes: teams.all (optional) and/or teams.delete.

The endpoint will respond with 200 OK on a successful request.

\n","urlObject":{"path":["v1","teams","{{team_id}}"],"host":["{{host}}"],"query":[],"variable":[]}},"response":[{"id":"eaf38d6f-38f4-426f-a440-4c85c453ba1e","name":"Read","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer {{access_token}}"}],"body":{"mode":"formdata","formdata":[]},"url":"{{host}}/v1/teams/{{team_id}}"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"private","name":"Cache-Control","description":""},{"key":"Connection","value":"keep-alive","name":"Connection","description":""},{"key":"Content-Type","value":"application/json; charset=utf-8","name":"Content-Type","description":""},{"key":"Date","value":"Mon, 19 Mar 2018 09:20:16 GMT","name":"Date","description":""},{"key":"Link","value":"; rel=\"application/xml\"","name":"Link","description":""},{"key":"Server","value":"Microsoft-IIS/10.0","name":"Server","description":""},{"key":"Vary","value":"Accept","name":"Vary","description":""},{"key":"transfer-encoding","value":"chunked","name":"transfer-encoding","description":""}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"team\": {\n \"id\": \"{{team_id}}\",\n \"name\": \"{{team_name}}\",\n \"rogerAddress\": \"generated-handle@pay.roger.ai\",\n \"owner\": {\n \"id\": \"{{user_id}}\"\n }\n }\n }\n}"}],"_postman_id":"e02c197c-4844-4abc-8006-41f92b204912"}],"id":"f15f7c24-f9fe-4464-a013-0e66f558182d","_postman_id":"f15f7c24-f9fe-4464-a013-0e66f558182d","description":"","auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"d1926441-fcff-43b1-907a-1a240d7eefbc","id":"d1926441-fcff-43b1-907a-1a240d7eefbc","name":"Roger API (Roger.ai)","type":"collection"}}},{"name":"Categories","item":[{"name":"Create (import)","id":"7a6ade60-077c-4e74-9397-8255b4645a5a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{external-api-token}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"Bearer {{access_token}}"}],"body":{"mode":"raw","raw":"{\n\t\"categories\": [\n\t\t{\n\t\t\t\"id\": 1,\n \t\t\"name\": \"Category A\",\n \t\t\"number\": \"1030\",\n \t\t\"selectable\": true\n\t\t},\n\t\t{\n\t\t\t\"id\": 2,\n\t\t\t\"name\": \"Category B\",\n\t\t\t\"number\": \"1045\",\n\t\t\t\"selectable\": true\n\t\t},\n\t\t{\n\t\t\t\"id\": 3,\n\t\t\t\"name\": \"Category A, Child 1\",\n\t\t\t\"number\": \"1033\",\n\t\t\t\"selectable\": true,\n\t\t\t\"parentId\": 1\n\t\t}\n\t]\n}"},"url":"{{host}}/v1/teams/{{team_id}}/categories","description":"

Import team categories. Given IDs must be unique and can be used to contruct an abitary parent to children relationship (maximum two levels, including parent). The IDs will be returned when created will be internal identifiers.

Scopes: teams.categories.all (optional) and/or teams.categories.create.

The endpoint will respond with 201 Created on a successful request.

⚠️ THIS WILL DELETE ALL EXISTING CATEGORIES AND CREDITOR MAPPINGS.

\n","urlObject":{"path":["v1","teams","{{team_id}}","categories"],"host":["{{host}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"7a6ade60-077c-4e74-9397-8255b4645a5a"},{"name":"Create (merge)","id":"c0d339fa-d4bf-47bf-b03a-509d9408d104","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{external-api-token}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"Bearer {{access_token}}"}],"body":{"mode":"raw","raw":"{\n\t\"categories\": [\n\t\t{\n\t\t\t\"id\": 1,\n \t\t\"name\": \"Category A\",\n \t\t\"number\": \"1030\",\n \t\t\"selectable\": true\n\t\t},\n\t\t{\n\t\t\t\"id\": 2,\n\t\t\t\"name\": \"Category B\",\n\t\t\t\"number\": \"1045\",\n\t\t\t\"selectable\": true\n\t\t},\n\t\t{\n\t\t\t\"id\": 3,\n\t\t\t\"name\": \"Category A, Child 1\",\n\t\t\t\"number\": \"1033\",\n\t\t\t\"selectable\": true,\n\t\t\t\"parentId\": 1\n\t\t}\n\t]\n}"},"url":"{{host}}/v1/teams/{{team_id}}/categories","description":"

Merge team categories. Given IDs must be unique and can be used to contruct an abitary parent to children relationship (maximum two levels, including parent). The IDs will be returned when created will be internal identifiers.

Scopes: teams.categories.all (optional) and/or teams.categories.create.

The endpoint will respond with 201 Created on a successful request.

⚠️ THIS WILL KEEP ALL EXISTING CATEGORIES AND CREDITOR MAPPINGS.

\n","urlObject":{"path":["v1","teams","{{team_id}}","categories"],"host":["{{host}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"c0d339fa-d4bf-47bf-b03a-509d9408d104"},{"name":"List","id":"1882162f-9a78-4a51-b4af-918644f149ef","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{external-api-token}}"}]},"isInherited":false},"method":"GET","header":[{"warning":"This is a duplicate header and will be overridden by the Authorization header generated by Postman.","key":"Authorization","value":"Bearer {{access_token}}"}],"url":"{{host}}/v1/teams/{{team_id}}/categories","description":"

List team categories.

Scopes: teams.categories.all (optional) and/or teams.categories.list.

\n","urlObject":{"path":["v1","teams","{{team_id}}","categories"],"host":["{{host}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"1882162f-9a78-4a51-b4af-918644f149ef"},{"name":"Read","id":"9b4aac97-45c1-48e4-a31f-8ace249883b8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{external-api-token}}"}]},"isInherited":false},"method":"GET","header":[{"warning":"This is a duplicate header and will be overridden by the Authorization header generated by Postman.","key":"Authorization","value":"Bearer {{access_token}}"}],"url":"{{host}}/v1/teams/{{team_id}}/categories/{{category_id}}","description":"

Get a team category.

Scopes: teams.categories.all (optional) and/or teams.categories.read.

\n","urlObject":{"path":["v1","teams","{{team_id}}","categories","{{category_id}}"],"host":["{{host}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"9b4aac97-45c1-48e4-a31f-8ace249883b8"},{"name":"Delete","id":"efbe3a06-f952-486b-82c4-cee0411edf30","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{external-api-token}}"}]},"isInherited":false},"method":"DELETE","header":[{"warning":"This is a duplicate header and will be overridden by the Authorization header generated by Postman.","key":"Authorization","value":"Bearer {{access_token}}"}],"url":"{{host}}/v1/teams/{{team_id}}/categories/{{category_id}}","description":"

Delete a team category.

Scopes: teams.categories.all (optional) and/or teams.categories.delete.

The categories for a team, which can be assigned to a bill. Currently, a category number is only available if the categories have been imported and set during this process.

⚠️ PREVIEW

\n","event":[{"listen":"prerequest","script":{"id":"65990830-703c-4536-92fe-24991d48b6d6","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"1c94f1c9-016d-4e41-bd84-3e784baca769","type":"text/javascript","exec":[""]}}],"_postman_id":"f620992b-8e2d-4b8d-821b-b703e5cbff46","auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"d1926441-fcff-43b1-907a-1a240d7eefbc","id":"d1926441-fcff-43b1-907a-1a240d7eefbc","name":"Roger API (Roger.ai)","type":"collection"}}},{"name":"Departments","item":[{"name":"Create","id":"6b555e43-d4b1-4e63-a277-d03d490d7631","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{external-api-token}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/x-www-form-urlencoded"},{"key":"Authorization","value":"Bearer {{access_token}}"}],"body":{"mode":"formdata","formdata":[{"key":"name","value":"{{departmentName}}","type":"text"}]},"url":"{{host}}/v1/teams/{{team_id}}/departments","description":"

Create team department.

Scopes: departments.all (optional) and/or departments.create.

The endpoint will respond with 201 Created on a successful request.

\n","urlObject":{"path":["v1","teams","{{team_id}}","departments"],"host":["{{host}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"6b555e43-d4b1-4e63-a277-d03d490d7631"},{"name":"Read","id":"2a84a4ab-4866-4fa0-85a2-27e94a23311e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{external-api-token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/x-www-form-urlencoded"},{"key":"Authorization","value":"Bearer {{access_token}}"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"{{host}}/v1/teams/{{team_id}}/departments/{{department_id}}","description":"

Get team department.

Scopes: departments.all (optional) and/or departments.read.

The endpoint will respond with 200 OK on a successful request.

\n","urlObject":{"path":["v1","teams","{{team_id}}","departments","{{department_id}}"],"host":["{{host}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"2a84a4ab-4866-4fa0-85a2-27e94a23311e"},{"name":"Delete","id":"eddfa9ea-4d97-4ab3-9552-5f34bda8af7e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{external-api-token}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/x-www-form-urlencoded"},{"key":"Authorization","value":"Bearer {{access_token}}"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"{{host}}/v1/teams/{{team_id}}/departments/{{department_id}}","description":"

Delete team department.

Scopes: departments.all (optional) and/or departments.delete.

The endpoint will respond with 200 OK on a successful request.

\n","urlObject":{"path":["v1","teams","{{team_id}}","departments","{{department_id}}"],"host":["{{host}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"eddfa9ea-4d97-4ab3-9552-5f34bda8af7e"},{"name":"List","id":"e7660cf3-2b22-4033-8c68-b420610c8cda","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{external-api-token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Authorization","value":"Bearer {{access_token}}"}],"url":"{{host}}/v1/teams/{{team_id}}/departments","description":"

Get/list team's departments of the authenticated user.

Scopes: departments.all (optional) and/or departments.list.

The endpoint will respond with 200 OK on a successful request.

\n","urlObject":{"path":["v1","teams","{{team_id}}","departments"],"host":["{{host}}"],"query":[],"variable":[]}},"response":[{"id":"b11bceb0-907d-45f2-88a8-e78f5b174271","name":"List","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer {{access_token}}","warning":"This is a duplicate header and will be overridden by the Authorization header generated by Postman."}],"body":{"mode":"formdata","formdata":[]},"url":"{{host}}/v1/teams"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"private","name":"Cache-Control","description":""},{"key":"Connection","value":"keep-alive","name":"Connection","description":""},{"key":"Content-Length","value":"21","name":"Content-Length","description":""},{"key":"Content-Type","value":"application/json; charset=utf-8","name":"Content-Type","description":""},{"key":"Date","value":"Mon, 19 Mar 2018 09:32:36 GMT","name":"Date","description":""},{"key":"Link","value":"; rel=\"application/xml\"","name":"Link","description":""},{"key":"Server","value":"Microsoft-IIS/10.0","name":"Server","description":""},{"key":"Vary","value":"Accept","name":"Vary","description":""}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"teams\": [\n {\n \"id\": \"{{team_id}}\"\n }\n ]\n }\n}"}],"_postman_id":"e7660cf3-2b22-4033-8c68-b420610c8cda"},{"name":"Merge","id":"c8b9230e-10e5-4d0d-ad46-d73c1faf00c1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{external-api-token}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Content-Type","name":"Content-Type","value":"text/plain","type":"text"},{"key":"Authorization","value":"Bearer {{access_token}}"}],"body":{"mode":"raw","raw":"{\n departments:[{\n\tname: \"Departmen1\"\n },\n {\n \tname: \"Departmen2\"\n }]\n}"},"url":"{{host}}/v1/teams/{{team_id}}/departments","description":"

Merge team's departments.

Scopes: departments.all (optional) and/or departments.create.

The endpoint will respond with 201 Created on a successful request.

\n","urlObject":{"path":["v1","teams","{{team_id}}","departments"],"host":["{{host}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"c8b9230e-10e5-4d0d-ad46-d73c1faf00c1"}],"id":"f604dddf-001e-428d-87f4-952c7bdd9e21","description":"

The departments for a team, which can be assigned to a bill.

\n","event":[{"listen":"prerequest","script":{"id":"c418f572-bd30-4aa6-b659-29e8155b09a0","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"bd91c7d8-053c-4dd9-afc5-98dfe94c2ae8","type":"text/javascript","exec":[""]}}],"_postman_id":"f604dddf-001e-428d-87f4-952c7bdd9e21","auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"d1926441-fcff-43b1-907a-1a240d7eefbc","id":"d1926441-fcff-43b1-907a-1a240d7eefbc","name":"Roger API (Roger.ai)","type":"collection"}}},{"name":"Lists","item":[{"name":"Labels","item":[{"name":"Create(import)","id":"0b6d42b4-ef6f-4718-bd50-83c8f7a0c4ce","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{external-api-token}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/json"},{"warning":"This is a duplicate header and will be overridden by the Authorization header generated by Postman.","key":"Authorization","value":"Bearer {{access_token}}","type":"text"}],"body":{"mode":"raw","raw":"{\n\t\"labels\": [\n\t\t{\n\t\t\t\"value\": 1,\n \t\t\"externalId\": \"Category A\"\n\t\t}\n\t]\n}","options":{"raw":{"language":"json"}}},"url":"{{host}}/v1/teams/{{team_id}}/lists/{{llist_id}}/labels","description":"

Import team list labels.

Scopes: teams.lists.all (optional) and/or teams.lists.create.

The endpoint will respond with 201 Created on a successful request.

⚠️ THIS WILL OVERRIDE ALL EXISTING LABELS.

\n","urlObject":{"path":["v1","teams","{{team_id}}","lists","{{llist_id}}","labels"],"host":["{{host}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"0b6d42b4-ef6f-4718-bd50-83c8f7a0c4ce"},{"name":"Create(import) Async","id":"c5bb7a72-04c1-4384-99b7-90c6a98606df","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{external-api-token}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/json"},{"warning":"This is a duplicate header and will be overridden by the Authorization header generated by Postman.","key":"Authorization","value":"Bearer {{access_token}}","type":"text"}],"body":{"mode":"raw","raw":"{\n\t\"labels\": [\n\t\t{\n\t\t\t\"value\": 1,\n \t\t\"externalId\": \"Category A\"\n\t\t}\n\t]\n}","options":{"raw":{"language":"json"}}},"url":"{{host}}/v1/teams/{{team_id}}/lists/{{llist_id}}/labels/async","description":"

Import team list labels in background.

Scopes: teams.lists.all (optional) and/or teams.lists.create.

The endpoint will respond with 201 Created on a successful request.

⚠️ THIS WILL OVERRIDE ALL EXISTING LABELS.

\n","urlObject":{"path":["v1","teams","{{team_id}}","lists","{{llist_id}}","labels","async"],"host":["{{host}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"c5bb7a72-04c1-4384-99b7-90c6a98606df"},{"name":"Create(merge)","id":"c1b7f8d1-5e10-44a4-bd97-61a39afce44a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{external-api-token}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/json"},{"warning":"This is a duplicate header and will be overridden by the Authorization header generated by Postman.","key":"Authorization","value":"Bearer {{access_token}}","type":"text"}],"body":{"mode":"raw","raw":"{\n\t\"labels\": [\n\t\t{\n\t\t\t\"value\": 1,\n \t\t\"externalId\": \"Category A\"\n\t\t}\n\t]\n}","options":{"raw":{"language":"json"}}},"url":"{{host}}/v1/teams/{{team_id}}/lists/{{llistId}}/labels","description":"

Merge team list labels.

Scopes: teams.lists.all (optional) and/or teams.lists.create.

The endpoint will respond with 201 Created on a successful request.

⚠️ THIS WILL MERGE THE LABELS. THE EXISTING USED LABELS WILL NOT BE DELETED.

\n","urlObject":{"path":["v1","teams","{{team_id}}","lists","{{llistId}}","labels"],"host":["{{host}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"c1b7f8d1-5e10-44a4-bd97-61a39afce44a"},{"name":"Create(merge) Async","id":"8b34363c-9a5a-400c-9d7d-f47e7f2458b8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{external-api-token}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/json"},{"warning":"This is a duplicate header and will be overridden by the Authorization header generated by Postman.","key":"Authorization","value":"Bearer {{access_token}}","type":"text"}],"body":{"mode":"raw","raw":"{\n\t\"labels\": [\n\t\t{\n\t\t\t\"value\": 1,\n \t\t\"externalId\": \"Category A\"\n\t\t}\n\t]\n}","options":{"raw":{"language":"json"}}},"url":"{{host}}/v1/teams/{{team_id}}/lists/{{llistId}}/labels/async","description":"

Merge team list labels in background.

Scopes: teams.lists.all (optional) and/or teams.lists.create.

The endpoint will respond with 201 Created on a successful request.

⚠️ THIS WILL MERGE THE LABELS. THE EXISTING USED LABELS WILL NOT BE DELETED.

\n","urlObject":{"path":["v1","teams","{{team_id}}","lists","{{llistId}}","labels","async"],"host":["{{host}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"8b34363c-9a5a-400c-9d7d-f47e7f2458b8"},{"name":"Read","id":"83e9fb61-b3e6-4280-923c-1deaba49a140","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{external-api-token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/x-www-form-urlencoded"},{"warning":"This is a duplicate header and will be overridden by the Authorization header generated by Postman.","key":"Authorization","value":"Bearer {{access_token}}","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"type","type":"text","value":""},{"key":"name","type":"text","value":""},{"key":"origin","type":"text","value":""}]},"url":"{{host}}/v1/teams/{{team_id}}/lists/{{llist_id}}/labels/{{label_id}}","description":"

Get a team list label.

Scopes: teams.lists.all (optional) and/or teams.lists.read.

\n","urlObject":{"path":["v1","teams","{{team_id}}","lists","{{llist_id}}","labels","{{label_id}}"],"host":["{{host}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"83e9fb61-b3e6-4280-923c-1deaba49a140"},{"name":"List","id":"965ebf5f-0801-4185-a82a-a8d743e8b332","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{external-api-token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/x-www-form-urlencoded"},{"warning":"This is a duplicate header and will be overridden by the Authorization header generated by Postman.","key":"Authorization","value":"Bearer {{access_token}}","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"type","type":"text","value":""},{"key":"name","type":"text","value":""},{"key":"origin","type":"text","value":""}]},"url":"{{host}}/v1/teams/{{team_id}}/lists/{{llist_id}}/labels","description":"

List team list label

Scopes: teams.lists.all (optional) and/or teams.lists.list.

\n","urlObject":{"path":["v1","teams","{{team_id}}","lists","{{llist_id}}","labels"],"host":["{{host}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"965ebf5f-0801-4185-a82a-a8d743e8b332"}],"id":"437d467d-e38d-419a-8b3c-89b5d6640fd6","_postman_id":"437d467d-e38d-419a-8b3c-89b5d6640fd6","description":"","auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"d1926441-fcff-43b1-907a-1a240d7eefbc","id":"d1926441-fcff-43b1-907a-1a240d7eefbc","name":"Roger API (Roger.ai)","type":"collection"}}},{"name":"Create","id":"b105e118-d68b-41b9-a3b7-df7f26a744d1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{external-api-token}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","value":"application/x-www-form-urlencoded","type":"text","description":"

application/json is also supported.

Required field

\n"},{"key":"name","value":"","type":"text"},{"key":"origin","value":"","type":"text"},{"key":"onBills","value":"","type":"text"},{"key":"onCreditnotes","value":"","type":"text"},{"key":"onReceipts","value":"","type":"text"}]},"url":"{{host}}/v1/teams/{{team_id}}/lists","description":"

Create team list.

Scopes: teams.lists.all (optional) and/or teams.lists.create.

The endpoint will respond with 201 Created on a successful request.

\n","urlObject":{"path":["v1","teams","{{team_id}}","lists"],"host":["{{host}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"b105e118-d68b-41b9-a3b7-df7f26a744d1"},{"name":"Update","id":"444d2b45-8ccd-4575-8ec3-a6de6059d7b4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{external-api-token}}"}]},"isInherited":false},"method":"PATCH","header":[{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/x-www-form-urlencoded","description":"

application/json is also supported.

\n"},{"warning":"This is a duplicate header and will be overridden by the Authorization header generated by Postman.","key":"Authorization","value":"Bearer {{access_token}}","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"name","type":"text","value":""},{"key":"origin","type":"text","value":""},{"key":"onBills","type":"text","value":""},{"key":"onCreditnotes","type":"text","value":""},{"key":"onReceipts","type":"text","value":""}]},"url":"{{host}}/v1/teams/{{team_id}}/lists/{{list_id}}","description":"

Update team list.

Scopes: teams.lists.all (optional) and/or teams.lists.update.

The endpoint will respond with 201 Created on a successful request.

\n","urlObject":{"path":["v1","teams","{{team_id}}","lists","{{list_id}}"],"host":["{{host}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"444d2b45-8ccd-4575-8ec3-a6de6059d7b4"},{"name":"List","id":"f9d1d80e-74bc-48af-80b1-9083ad90d41f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{external-api-token}}"}]},"isInherited":false},"method":"GET","header":[{"warning":"This is a duplicate header and will be overridden by the Authorization header generated by Postman.","key":"Authorization","value":"Bearer {{access_token}}","type":"text"}],"url":"{{host}}/v1/teams/{{team_id}}/lists","description":"

List team lists.

Scopes: teams.lists.all (optional) and/or teams.lists.list.

\n","urlObject":{"path":["v1","teams","{{team_id}}","lists"],"host":["{{host}}"],"query":[],"variable":[]}},"response":[{"id":"ec3d5cc2-0ccc-4dba-b011-c0f14ad65d86","name":"List","originalRequest":{"method":"GET","header":[{"warning":"This is a duplicate header and will be overridden by the Authorization header generated by Postman.","key":"Authorization","value":"Bearer {{access_token}}","type":"text"}],"url":"{{host}}/v1/teams/{{team_id}}/lists"},"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":"{\r\n \"data\": {\r\n \"lists\": [\r\n {\r\n \"id\": \"74mjYBn0\",\r\n \"name\": \"Projects\",\r\n \"created\": \"2021-01-14T10:33:31Z\",\r\n \"dataType\": \"any\",\r\n \"origin\": \"the-origin\",\r\n \"onBills\": true,\r\n \"onCreditnotes\": true,\r\n \"onReceipts\": true,\r\n \"domain\": \"documents\",\r\n \"type\": \"Projects\",\r\n \"isLocked\": true,\r\n \"labels\": [\r\n {\r\n \"id\": \"M6gdyLr3\",\r\n \"externalId\": \"2\",\r\n \"value\": \"2 Projekt NYC\",\r\n \"listId\": \"74mjYBn0\"\r\n },\r\n {\r\n \"id\": \"74mjYBn0\",\r\n \"externalId\": \"3\",\r\n \"value\": \"3 Project CPH\",\r\n \"listId\": \"74mjYBn0\"\r\n },\r\n {\r\n \"id\": \"4em12gxk\",\r\n \"externalId\": \"6\",\r\n \"value\": \"6 55555\",\r\n \"listId\": \"74mjYBn0\"\r\n },\r\n {\r\n \"id\": \"5ELZjL4K\",\r\n \"externalId\": \"9\",\r\n \"value\": \"9 Projeckt EU\",\r\n \"listId\": \"74mjYBn0\"\r\n },\r\n {\r\n \"id\": \"a1LepgbG\",\r\n \"externalId\": \"10\",\r\n \"value\": \"10 Project DKK\",\r\n \"listId\": \"74mjYBn0\"\r\n }\r\n ]\r\n },\r\n {\r\n \"id\": \"4em12gxk\",\r\n \"name\": \"CostNumbers\",\r\n \"created\": \"2021-01-14T10:33:31Z\",\r\n \"dataType\": \"any\",\r\n \"origin\": \"the-origin\",\r\n \"onBills\": true,\r\n \"onCreditnotes\": true,\r\n \"onReceipts\": true,\r\n \"domain\": \"documents\",\r\n \"type\": \"CostNumbers\",\r\n \"isLocked\": true,\r\n \"labels\": [\r\n {\r\n \"id\": \"nAmYGLaX\",\r\n \"externalId\": \"1\",\r\n \"value\": \"1 TestCostType\",\r\n \"listId\": \"4em12gxk\"\r\n },\r\n {\r\n \"id\": \"wXLJnLWy\",\r\n \"externalId\": \"2\",\r\n \"value\": \"2 CostTypeWithVat\",\r\n \"listId\": \"4em12gxk\"\r\n }\r\n ]\r\n },\r\n {\r\n \"id\": \"5ELZjL4K\",\r\n \"name\": \"VatCodes\",\r\n \"created\": \"2021-01-14T10:33:32Z\",\r\n \"dataType\": \"any\",\r\n \"origin\": \"the-origin\",\r\n \"onBills\": true,\r\n \"onCreditnotes\": true,\r\n \"onReceipts\": true,\r\n \"domain\": \"documents\",\r\n \"type\": \"VatCodes\",\r\n \"isLocked\": true,\r\n \"labels\": [\r\n {\r\n \"id\": \"Q6LlRmao\",\r\n \"externalId\": \"Ingen moms\",\r\n \"value\": \"Ingen moms - Momsfri køb\",\r\n \"listId\": \"5ELZjL4K\"\r\n },\r\n {\r\n \"id\": \"dYgz7Lb2\",\r\n \"externalId\": \"Abr\",\r\n \"value\": \"Abr - Salg udenfor EU\",\r\n \"listId\": \"5ELZjL4K\"\r\n },\r\n {\r\n \"id\": \"kyB3pmMr\",\r\n \"externalId\": \"B25\",\r\n \"value\": \"B25 - Byggeydelser udland\",\r\n \"listId\": \"5ELZjL4K\"\r\n },\r\n {\r\n \"id\": \"QABNYLd6\",\r\n \"externalId\": \"I25\",\r\n \"value\": \"I25 - Indgående (køb)\",\r\n \"listId\": \"5ELZjL4K\"\r\n },\r\n {\r\n \"id\": \"jZgwKg6J\",\r\n \"externalId\": \"IV25\",\r\n \"value\": \"IV25 - Indgående (køb) varer udland\",\r\n \"listId\": \"5ELZjL4K\"\r\n },\r\n {\r\n \"id\": \"yrBxoLz5\",\r\n \"externalId\": \"IY25\",\r\n \"value\": \"IY25 - Indgående (køb) ydelser udland\",\r\n \"listId\": \"5ELZjL4K\"\r\n },\r\n {\r\n \"id\": \"JKg5ag7N\",\r\n \"externalId\": \"OBPK\",\r\n \"value\": \"OBPK - Køb med omvendt betalingspligt\",\r\n \"listId\": \"5ELZjL4K\"\r\n },\r\n {\r\n \"id\": \"KamkbBN3\",\r\n \"externalId\": \"OBPS\",\r\n \"value\": \"OBPS - Salg med omvendt betalingspligt\",\r\n \"listId\": \"5ELZjL4K\"\r\n },\r\n {\r\n \"id\": \"vlgo7g09\",\r\n \"externalId\": \"REP\",\r\n \"value\": \"REP - Repræsentation\",\r\n \"listId\": \"5ELZjL4K\"\r\n },\r\n {\r\n \"id\": \"yvBXKLkJ\",\r\n \"externalId\": \"U25\",\r\n \"value\": \"U25 - Udgående (salg)\",\r\n \"listId\": \"5ELZjL4K\"\r\n },\r\n {\r\n \"id\": \"4Mg9XmrN\",\r\n \"externalId\": \"UEUV\",\r\n \"value\": \"UEUV - Salg af varer indenfor EU\",\r\n \"listId\": \"5ELZjL4K\"\r\n },\r\n {\r\n \"id\": \"97B2Gmzl\",\r\n \"externalId\": \"UY0\",\r\n \"value\": \"UY0 - Udgående (salg) ydelser indenfor EU\",\r\n \"listId\": \"5ELZjL4K\"\r\n }\r\n ]\r\n }\r\n ]\r\n }\r\n}"}],"_postman_id":"f9d1d80e-74bc-48af-80b1-9083ad90d41f"},{"name":"Read","id":"956fd956-64d4-42e5-80ab-997a14dda642","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{external-api-token}}"}]},"isInherited":false},"method":"GET","header":[{"warning":"This is a duplicate header and will be overridden by the Authorization header generated by Postman.","key":"Authorization","value":"Bearer {{access_token}}","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"{{host}}/v1/teams/{{teamId}}/lists/{{list_id}}","description":"

Get team list.

Scopes: teams.lists.all (optional) and/or teams.lists.read.

The endpoint will respond with 200 OK on a successful request.

\n","urlObject":{"path":["v1","teams","{{teamId}}","lists","{{list_id}}"],"host":["{{host}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"956fd956-64d4-42e5-80ab-997a14dda642"},{"name":"Delete","id":"eddc6880-d294-49c5-804c-3e04e24439a7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{external-api-token}}"}]},"isInherited":false},"method":"DELETE","header":[{"warning":"This is a duplicate header and will be overridden by the Authorization header generated by Postman.","key":"Authorization","value":"Bearer {{access_token}}","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"{{host}}/v1/teams/{{teamId}}/lists/{{list_id}}","description":"

Delete team list.

Scopes: teams.lists.all (optional) and/or teams.lists.delete.

The endpoint will respond with 200 OK on a successful request.

The lists for a team, which can be assigned to an expense. Currently, an external id is used to identified an entry from the source.

\n","event":[{"listen":"prerequest","script":{"id":"232fbeb6-c3e8-4723-9dad-ed202ff4ab21","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"ac292c26-3e53-4f09-aa88-244d7f181300","type":"text/javascript","exec":[""]}}],"_postman_id":"02a70bf7-dd15-4221-9dce-0f67fc6ffd6b","auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"d1926441-fcff-43b1-907a-1a240d7eefbc","id":"d1926441-fcff-43b1-907a-1a240d7eefbc","name":"Roger API (Roger.ai)","type":"collection"}}},{"name":"Members","item":[{"name":"List","id":"e8d171b1-77db-4f13-b9ac-a728db518c06","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{external-api-token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Authorization","value":"Bearer {{access_token}}"}],"url":"{{host}}/v1/teams/{{teamId}}/members","description":"

Get/list team's members of the authenticated user.

Scopes: team.members.all (optional) and/or team.members.list.

The endpoint will respond with 200 OK on a successful request.

\n","urlObject":{"path":["v1","teams","{{teamId}}","members"],"host":["{{host}}"],"query":[],"variable":[]}},"response":[{"id":"80cb35aa-96cc-47f3-8731-e7c9da375f00","name":"List","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer {{access_token}}","warning":"This is a duplicate header and will be overridden by the Authorization header generated by Postman."}],"body":{"mode":"formdata","formdata":[]},"url":"{{host}}/v1/teams"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"private","name":"Cache-Control","description":""},{"key":"Connection","value":"keep-alive","name":"Connection","description":""},{"key":"Content-Length","value":"21","name":"Content-Length","description":""},{"key":"Content-Type","value":"application/json; charset=utf-8","name":"Content-Type","description":""},{"key":"Date","value":"Mon, 19 Mar 2018 09:32:36 GMT","name":"Date","description":""},{"key":"Link","value":"; rel=\"application/xml\"","name":"Link","description":""},{"key":"Server","value":"Microsoft-IIS/10.0","name":"Server","description":""},{"key":"Vary","value":"Accept","name":"Vary","description":""}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"teams\": [\n {\n \"id\": \"{{team_id}}\"\n }\n ]\n }\n}"}],"_postman_id":"e8d171b1-77db-4f13-b9ac-a728db518c06"},{"name":"Create","id":"055883a8-9edc-4bd4-a5f6-63fae1dcb1c0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{external-api-token}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"},{"warning":"This is a duplicate header and will be overridden by the Authorization header generated by Postman.","key":"Authorization","value":"Bearer {{access_token}}"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"email","type":"text","value":"","description":"

Email of the new team member

\n"},{"key":"name","type":"text","value":"","description":"

Full name of the new team member

\n"},{"key":"isConfined ","value":"","description":"

Can team member only see their own expenses

\n","type":"text"},{"key":"requireApproval","value":"","description":"

Expenses uploaded by this user will require approval

\n","type":"text"},{"key":"isAppointer ","value":"","description":"

Can appoint new users as approvers on an expense

\n","type":"text"},{"key":"appointerLevel","value":"","description":"

What level of appointer is this user. Note: The isAppointer has to be true. Values: 0 = All expenses, 1 = Own expenses

\n","type":"text"},{"key":"role","value":"","description":"

What role should be assigned \n OWNER = 0,\n ADMIN = 1,
CONTRIBUTER = 2,
VIEWER = 3,\n ACCOUNTANT = 4

\n","type":"text"}]},"url":"{{host}}/v1/teams/{{team_id}}/members","description":"

Scopes: teams.members.all (optional) and/or teams.members.create.

The endpoint will respond with 201 Created on a successful request.

\n","urlObject":{"path":["v1","teams","{{team_id}}","members"],"host":["{{host}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"055883a8-9edc-4bd4-a5f6-63fae1dcb1c0"},{"name":"Update","id":"79276574-6c90-4a23-9795-be11e92a3156","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{external-api-token}}"}]},"isInherited":false},"method":"PATCH","header":[{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/x-www-form-urlencoded"},{"key":"Authorization","value":"Bearer {{access_token}}"}],"body":{"mode":"urlencoded","urlencoded":[{"description":"

Can team member only see their own expenses

\n","key":"isConfined ","type":"text","value":""},{"description":"

Expenses uploaded by this user will require approval

\n","key":"requireApproval","type":"text","value":""},{"description":"

Can appoint new users as approvers on an expense

\n","key":"isAppointer ","type":"text","value":""},{"description":"

What level of appointer is this user. Note: The isAppointer has to be true. Values: 0 = All expenses, 1 = Own expenses

\n","key":"appointerLevel","type":"text","value":""},{"key":"role","value":"","description":"

What role should be assigned \n OWNER = 0,\n ADMIN = 1,
CONTRIBUTER = 2,
VIEWER = 3,\n ACCOUNTANT = 4

\n","type":"text"}]},"url":"{{host}}/v1/teams/{{team_id}}/members/{{userId}}","description":"

Scopes: teams.members.all (optional) and/or teams.members.create.

The endpoint will respond with 201 Created on a successful request.

\n","urlObject":{"path":["v1","teams","{{team_id}}","members","{{userId}}"],"host":["{{host}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"79276574-6c90-4a23-9795-be11e92a3156"},{"name":"Delete","id":"723f4df8-aa8b-4aa9-9844-d05a223ea1ea","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{external-api-token}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/x-www-form-urlencoded"},{"key":"Authorization","value":"Bearer {{access_token}}"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"{{host}}/v1/teams/{{team_id}}/members/{{user_id}}","description":"

Scopes: teams.members.all (optional) and/or teams.members.create.

The endpoint will respond with 200 OK on a successful request.

\n","urlObject":{"path":["v1","teams","{{team_id}}","members","{{user_id}}"],"host":["{{host}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"723f4df8-aa8b-4aa9-9844-d05a223ea1ea"}],"id":"18864dec-6374-4bd9-bd2b-594d2e1bbae6","_postman_id":"18864dec-6374-4bd9-bd2b-594d2e1bbae6","description":"","auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"d1926441-fcff-43b1-907a-1a240d7eefbc","id":"d1926441-fcff-43b1-907a-1a240d7eefbc","name":"Roger API (Roger.ai)","type":"collection"}}},{"name":"Vendors","item":[{"name":"Create","id":"577edff0-2ccf-4ff1-9d6f-33f3ae6f9767","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{external-api-token}}"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"[{\n\t\t\"Name\": \"Vendor 1\",\n\t\t\"Website\": \"www.vendor.com\",\n\t\t\"Email\": \"email@email.com\",\n\t\t\"Address\": \"1 Main St\",\n\t\t\"City\": \"San Francisco\",\n\t\t\"State\": \"CA\",\n\t\t\"Postal\": \"94102\",\n\t\t\"Country\": \"US\" // 2-Alpha country code\n\t},\n\t{\n\t\t\"Name\": \"Vendor 2\",\n\t\t\"Website\": \"www.vendor.com\",\n\t\t\"Email\": \"email@email.com\",\n\t\t\"Address\": \"2 Main St\",\n\t\t\"City\": \"San Francisco\",\n\t\t\"State\": \"CA\",\n\t\t\"Postal\": \"94102\",\n\t\t\"Country\": \"US\" // 2-Alpha country code\n\t}\n]","options":{"raw":{"language":"javascript"}}},"url":"{{host}}/v2/teams/{{teamId}}/vendors","description":"

View/read a vendor.

Scopes: teams.vendors.all (optional) and/or teams.vendors.read.

On a successful request the endpoint will respond with 200 OK with a full vendor payload.

\n","urlObject":{"path":["v2","teams","{{teamId}}","vendors"],"host":["{{host}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"577edff0-2ccf-4ff1-9d6f-33f3ae6f9767"},{"name":"Read","id":"61aaf7a2-3254-4df8-837a-0187d9257a6b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{external-api-token}}"}]},"isInherited":false},"method":"GET","header":[],"url":"{{host}}/v2/teams/{{teamId}}/vendors/{{vendor_id}}","description":"

View/read a vendor.

Scopes: teams.vendors.all (optional) and/or teams.vendors.read.

On a successful request the endpoint will respond with 200 OK with a full vendor payload.

\n","urlObject":{"path":["v2","teams","{{teamId}}","vendors","{{vendor_id}}"],"host":["{{host}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"61aaf7a2-3254-4df8-837a-0187d9257a6b"},{"name":"List","id":"925e2c62-8884-4355-907e-d317f6ea1abc","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{external-api-token}}"}]},"isInherited":false},"method":"GET","header":[],"url":"{{host}}/v2/teams/{{teamId}}/vendors","description":"

List vendors.

Scopes: teams.vendors.all (optional) and/or teams.vendors.list.

On a successful request the endpoint will respond with 200 OK with a full vendors list payload.

\n","urlObject":{"path":["v2","teams","{{teamId}}","vendors"],"host":["{{host}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"925e2c62-8884-4355-907e-d317f6ea1abc"}],"id":"da7d18d4-286a-4bc1-9cf3-21396b32813d","_postman_id":"da7d18d4-286a-4bc1-9cf3-21396b32813d","description":"","auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"d1926441-fcff-43b1-907a-1a240d7eefbc","id":"d1926441-fcff-43b1-907a-1a240d7eefbc","name":"Roger API (Roger.ai)","type":"collection"}}}],"id":"2484394b-d762-44d5-8fb2-1c1ce96dcf7a","description":"

In Roger a team corresponds to a company. \nAvailable scopes: teams.all, teams.create, teams.read, teams.update, teams.delete and teams.list.

\n","event":[{"listen":"prerequest","script":{"id":"353a268c-af3c-485c-9437-695563f1d752","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"264151f0-c634-480d-9e67-3d91d4e7cfee","type":"text/javascript","exec":[""]}}],"_postman_id":"2484394b-d762-44d5-8fb2-1c1ce96dcf7a","auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"d1926441-fcff-43b1-907a-1a240d7eefbc","id":"d1926441-fcff-43b1-907a-1a240d7eefbc","name":"Roger API (Roger.ai)","type":"collection"}}},{"name":"Payments","item":[{"name":"Methods","item":[{"name":"Create","id":"dd9190fe-67e6-427c-8cfe-0eb5990e6b08","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{external-api-token}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Authorization","value":"Bearer {{access_token}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"type\": \"card\",\r\n \"userId\": \"{{user_id}}\",\r\n \"teamId\": \"{{team_id}}\",\r\n \"card\": {\r\n \"cvc\": 123,\r\n \"cardHolder\": \"Jane Doe\",\r\n \"expiration\": {\r\n \"month\": 4,\r\n \"year\": 2020\r\n },\r\n \"number\": \"4242424242424242\"\r\n }\r\n}"},"url":"{{host}}/v1/payments/methods","description":"

Add/create payment methods. The payment method type of card is currently the only supported one.

🛡 This request currently requires the API consumer to be PCI compliant, and is only supported with the client credentials flow for selected partners.

Scopes: payments.methods.all (optional) and/or payments.methods.create.

Due to the complexity, a JSON payload must be sent in the body of the request. teamId is optional, and for all the fields for the card object, only card.cvc and card.cardHolder are optional.

The endpoint will respond with 201 Created on a successful request. The Location header contains the API location of the newly created entity (WIP).

\n","urlObject":{"path":["v1","payments","methods"],"host":["{{host}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"dd9190fe-67e6-427c-8cfe-0eb5990e6b08"},{"name":"Read (card)","id":"38a8c7d5-3678-4848-a050-bab777ef5ec9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{external-api-token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Authorization","value":"Bearer {{access_token}}"}],"url":"{{host}}/v1/payments/methods/cards/{{card_id}}","description":"

⚠️ PREVIEW

View/read a card (payment method).

Scopes: payments.methods.all (optional) and/or payments.methods.read.

On a successful request the endpoint will respond with 200 OK with a full card (payment method) payload.

\n","urlObject":{"path":["v1","payments","methods","cards","{{card_id}}"],"host":["{{host}}"],"query":[],"variable":[]}},"response":[{"id":"6dc40b11-0e1f-40f9-aef7-dbb4afbb070c","name":"Read (card)","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer {{access_token}}"}],"url":"{{host}}/v1/payments/methods/cards/{{card_id}}"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"card\": {\n \"id\": \"{{card_id}}\",\n \"created\": \"ISO Date\",\n \"type\": \"VISA\",\n \"friendlyName\": \"My favorite card\",\n \"expireMonth\": 1,\n \"expireYear\": 2020,\n \"lastFour\": \"1234\",\n \"isFailing\": false,\n \"owner\": {\n \"user\": {\n \"id\": \"{{user_id}}\"\n },\n \"team\": {\n \"id\": \"{{team_id}}\"\n }\n }\n }\n }\n}"}],"_postman_id":"38a8c7d5-3678-4848-a050-bab777ef5ec9"},{"name":"Read (bank account)","id":"38dd3762-2a28-45d3-9865-250d27147861","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{external-api-token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Authorization","value":"Bearer {{access_token}}"}],"url":"{{host}}/v1/payments/methods/bank/accounts/{{account_id}}","description":"

⚠️ PREVIEW

View/read a bank account info (payment method).

Scopes: payments.methods.all (optional) and/or payments.methods.read.

On a successful request the endpoint will respond with 200 OK with bank account general info (payment method) payload.

\n","urlObject":{"path":["v1","payments","methods","bank","accounts","{{account_id}}"],"host":["{{host}}"],"query":[],"variable":[]}},"response":[{"id":"8778936a-1da0-44f2-985e-2c78df95d526","name":"Read (bank account)","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer {{access_token}}"}],"url":"{{host}}/v1/payments/methods/bank/accounts/{{account_id}}"},"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":"{\r\n \"data\": {\r\n \"bankAccount\": {\r\n \"id\": \"wXLJnLWy\",\r\n \"name\": \"Plaid Saving\",\r\n \"currency\": \"\",\r\n \"state\": 1,\r\n \"owner\": {\r\n \"user\": {\r\n \"id\": \"a1LepgbG\"\r\n },\r\n \"team\": {\r\n \"id\": \"5ELZjL4K\"\r\n }\r\n }\r\n }\r\n }\r\n}"}],"_postman_id":"38dd3762-2a28-45d3-9865-250d27147861"},{"name":"List","id":"20a06cfb-60c6-4731-94bc-b9ede993f6f4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{external-api-token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Authorization","value":"Bearer {{access_token}}"}],"url":"{{host}}/v1/payments/methods?teamId={{team_id}}","description":"

⚠️ PREVIEW

Get/list cards (payment methods).

Scopes: payments.methods.all (optional) and/or payments.methods.list.

On a successful request the endpoint will respond with 200 OK with a shallow list of cards (payment methods).

\n","urlObject":{"path":["v1","payments","methods"],"host":["{{host}}"],"query":[{"description":{"content":"

Optional.

\n","type":"text/plain"},"key":"teamId","value":"{{team_id}}"}],"variable":[]}},"response":[{"id":"ac5ff6f8-a58e-4d5c-b259-a96bc7896af0","name":"List","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer {{access_token}}"}],"url":{"raw":"{{host}}/v1/payments/methods?teamId={{team_id}}","host":["{{host}}"],"path":["v1","payments","methods"],"query":[{"key":"teamId","value":"{{team_id}}","description":"*Optional.*"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"cards\": [\n {\n \"id\": \"{{card_id}}\"\n },\n {\n \"id\": \"{{card_id}}\"\n }\n ]\n }\n}"}],"_postman_id":"20a06cfb-60c6-4731-94bc-b9ede993f6f4"}],"id":"9ca83441-5cc3-4bd3-b8a7-cca8a4e99bf7","description":"

Handle various payment methods.

Available scopes: payments.methods.all, payments.methods.create, payments.methods.read, payments.methods.update and payments.methods.delete.

\n","event":[{"listen":"prerequest","script":{"id":"2043fe94-5fac-4699-8a00-f9c83df5a51d","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"06743c2c-a755-41a6-ac93-e3550ddfca62","type":"text/javascript","exec":[""]}}],"_postman_id":"9ca83441-5cc3-4bd3-b8a7-cca8a4e99bf7","auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"d1926441-fcff-43b1-907a-1a240d7eefbc","id":"d1926441-fcff-43b1-907a-1a240d7eefbc","name":"Roger API (Roger.ai)","type":"collection"}}},{"name":"Deposits","item":[],"id":"356a4476-b48f-4fca-93d8-78c6076a20c1","description":"

⚠️ UNDER DEVELOPMENT

\n","event":[{"listen":"prerequest","script":{"id":"14cc5d98-5672-47f7-9602-9bcdfebfd461","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"421ed8f8-da6c-4999-a485-d44e9571829c","type":"text/javascript","exec":[""]}}],"_postman_id":"356a4476-b48f-4fca-93d8-78c6076a20c1","auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"d1926441-fcff-43b1-907a-1a240d7eefbc","id":"d1926441-fcff-43b1-907a-1a240d7eefbc","name":"Roger API (Roger.ai)","type":"collection"}}},{"name":"Withdrawals","item":[],"id":"6a6813c7-c9f7-4a07-8589-689c287e265f","description":"

⚠️ UNDER DEVELOPMENT

\n","event":[{"listen":"prerequest","script":{"id":"ab83372d-1059-46b5-b5cb-ad5900bc6ff4","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"834f56b5-2abd-445b-922c-618a6e15f8d0","type":"text/javascript","exec":[""]}}],"_postman_id":"6a6813c7-c9f7-4a07-8589-689c287e265f","auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"d1926441-fcff-43b1-907a-1a240d7eefbc","id":"d1926441-fcff-43b1-907a-1a240d7eefbc","name":"Roger API (Roger.ai)","type":"collection"}}},{"name":"Transfers","item":[],"id":"89391136-29e2-4871-b6d4-2a0f1b52fede","description":"

⚠️ UNDER DEVELOPMENT

\n","event":[{"listen":"prerequest","script":{"id":"b28bb7f0-a6a4-4087-9e46-c06ffe7b8c68","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"ffb270ff-c0f6-49ce-abca-6c8bfa9fd42a","type":"text/javascript","exec":[""]}}],"_postman_id":"89391136-29e2-4871-b6d4-2a0f1b52fede","auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"d1926441-fcff-43b1-907a-1a240d7eefbc","id":"d1926441-fcff-43b1-907a-1a240d7eefbc","name":"Roger API (Roger.ai)","type":"collection"}}}],"id":"030fd1d5-b897-4d65-850b-ac81f4b8609f","description":"

Handling of payment methods, deposits, withdrawals and transfers.

\n","_postman_id":"030fd1d5-b897-4d65-850b-ac81f4b8609f","auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"d1926441-fcff-43b1-907a-1a240d7eefbc","id":"d1926441-fcff-43b1-907a-1a240d7eefbc","name":"Roger API (Roger.ai)","type":"collection"}}}],"auth":{"type":"oauth2","oauth2":{"basicConfig":[]}},"event":[{"listen":"prerequest","script":{"id":"1e3e969c-5190-426f-a686-a8b9d83bfcf6","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"bd38d004-2441-4b41-935f-4dd05c39f043","type":"text/javascript","exec":[""]}}]}

Expense life-cycle

States

Pending

Awaiting

Booked

Initialized

If the expense is getting paid outside banking hours - either by a user or by the API - the expense will move to Initialized and automatically get paid when the sending bank allows for a successful transaction\nWebhook emitted when entering: expenses.state.initialized

Paid

Paused

Canceled / Declined

Using Webhooks

Events

Expense events

Team events

Endpoints

OAUTH

Create a Roger App

Refresh Token

Access Token

Events

Payload example for Event expense.state.paid:

Security

If the expense is getting paid outside banking hours - either by a user or by the API - the expense will move to `Initialized` and automatically get paid when the sending bank allows for a successful transaction\n
Webhook emitted when entering: `expenses.state.initialized`

Payload example for Event `expense.state.paid`: