Skip to main content
POST
Upload a receipt

Authorizations

Authorization
string
header
required

Organization API key created in Grain Settings → API. The key determines the organization and is limited to its assigned resource scopes. Write scopes imply the corresponding read scope.

Headers

X-Organization-Id
string

Required with OAuth access tokens for resource requests. Omit only for GET /api/v1/organizations. Optional with organization API keys; if supplied with an API key, it must match the key's organization.

Path Parameters

id
string
required

Resource ID

Body

multipart/form-data
file
file
required
description
string
Maximum string length: 500

Response

Uploaded attachment

id
string
required
fileName
string
required
mimeType
string
required

HEIC uploads are stored as JPEG.

fileSize
integer
required

Size in bytes.

source
string | null
required

Card platform that synced the receipt, such as RAMP. Null for uploads.

createdAt
string<date-time>
required
Last modified on October 10, 2026