For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
API StatusPartner Portal
HomeGuidesAPI ExplorerSDKsGitHubSupport
HomeGuidesAPI ExplorerSDKsGitHubSupport
  • API Concepts
    • Overview
    • Environments and URLs
    • Authentication
    • API versioning
    • Rate limiting
    • HTTP headers
    • Pagination, sorting, and filtering
  • General
  • Common
  • Accounts payable
  • Accounts receivable
  • E-invoicing
  • Payments
  • Accounting integration
  • Expense management
      • GETGet receipts
      • POSTCreate a receipt
      • POSTUpload a receipt from a file
      • GETGet a receipt by ID
      • DELDelete a receipt
      • PATCHUpdate a receipt
      • POSTAttach a file to a receipt
      • GETGet all line items of a receipt
      • POSTAdd a new line item to a receipt
      • DELDelete a line item from a receipt
      • PATCHUpdate a line item of a receipt
  • Utilities
LogoLogo
API StatusPartner Portal
Expense managementReceipts

Create a receipt

POST
/receipts
POST
/v1/receipts
$curl -X POST https://api.sandbox.monite.com/v1/receipts \
>     -H "x-monite-version: 2024-05-25" \
>     -H "x-monite-entity-id: 9d2b4c8f-2087-4738-ba91-7359683c49a4" \
>     -H "Authorization: Bearer <token>" \
>     -H "Content-Type: application/json" \
>     -d '{}'
1{
2  "id": "id",
3  "created_at": "2024-01-15T09:30:00Z",
4  "updated_at": "2024-01-15T09:30:00Z",
5  "origin": "upload",
6  "created_by_entity_user_id": "created_by_entity_user_id",
7  "currency": "AED",
8  "currency_exchange": {
9    "key": "value"
10  },
11  "description": "Payment for lunch with clients",
12  "document_id": "document_id",
13  "file_id": "123e4567-e89b-12d3-a456-426614174000",
14  "file_url": "file_url",
15  "issued_at": "2024-01-15T09:30:00Z",
16  "merchant_location": "merchant_location",
17  "merchant_name": "merchant_name",
18  "ocr_request_id": "ocr_request_id",
19  "ocr_status": "ocr_status",
20  "partner_metadata": {
21    "key": "value"
22  },
23  "sender": "hello@example.com",
24  "source_of_data": "ocr",
25  "total_amount": 1,
26  "transaction_id": "transaction_id"
27}
Was this page helpful?
Previous

Upload a receipt from a file

Next
Built with

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Headers

x-monite-versionstringRequired
x-monite-entity-idstringRequired
The ID of the entity that owns the requested resource.

Request

This endpoint expects an object.
base64_encoded_filestringOptional

Base64-encoded contents of the original receipt file.

currencyenumOptional
Currency code used in the receipt.
descriptionstringOptional<=1024 characters
Short transaction description.
document_idstringOptional<=255 characters
Unique receipt number assigned by the issuer.
issued_atdatetimeOptional
Receipt issued date and time.
merchant_locationstringOptional<=255 characters
Location of the merchant.
merchant_namestringOptional<=128 characters
Name of the merchant.
partner_metadatamap from strings to anyOptional
Metadata for partner needs
total_amountintegerOptional>=0

Total amount for the receipt in minor units (e.g. cents).

transaction_idstringOptionalformat: "uuid"
Transaction ID.

Response

Successful Response
idstringformat: "uuid"
Unique receipt ID.
created_atdatetime
Creation timestamp.
updated_atdatetime
Update timestamp.
originenum
Specifies how this receipt was created in Monite.
Allowed values:
created_by_entity_user_idstringformat: "uuid"
Entity user who created.
currencyenum
Currency code.
currency_exchangemap from strings to any
Currency exchange details.
descriptionstring<=1024 characters
Short transaction description.
document_idstring<=255 characters
Receipt number.
file_idstringformat: "uuid"
The id of the receipt file stored in the file saver.
file_urlstring
The URL of the receipt file stored in the file saver.
issued_atdatetime
Date when the receipt was issued.
merchant_locationstring<=255 characters
Merchant location.
merchant_namestring<=128 characters
Merchant name.
ocr_request_idstringformat: "uuid"
OCR request id.
ocr_statusstring
OCR status.
partner_metadatamap from strings to any
Partner metadata.
senderstringformat: "email"
The email address from which the invoice was sent to the entity.
source_of_dataenum
Source of data.
Allowed values:
total_amountinteger
Total amount in minor units.
transaction_idstringformat: "uuid"
Transaction ID.

Errors

400
Post Receipts Request Bad Request Error
401
Post Receipts Request Unauthorized Error
403
Post Receipts Request Forbidden Error
422
Post Receipts Request Unprocessable Entity Error
429
Post Receipts Request Too Many Requests Error