{
"code": "forbidden",
"message": "You do not have access to this organization.",
"error": "You do not have access to this organization.",
"details": {
"fields": [
{
"field": "amount",
"code": "invalid_type"
}
]
}
}
{
"code": "forbidden",
"message": "You do not have access to this organization.",
"error": "You do not have access to this organization.",
"details": {
"fields": [
{
"field": "amount",
"code": "invalid_type"
}
]
}
}
{
"code": "forbidden",
"message": "You do not have access to this organization.",
"error": "You do not have access to this organization.",
"details": {
"fields": [
{
"field": "amount",
"code": "invalid_type"
}
]
}
}
{
"code": "forbidden",
"message": "You do not have access to this organization.",
"error": "You do not have access to this organization.",
"details": {
"fields": [
{
"field": "amount",
"code": "invalid_type"
}
]
}
}
{
"code": "forbidden",
"message": "You do not have access to this organization.",
"error": "You do not have access to this organization.",
"details": {
"fields": [
{
"field": "amount",
"code": "invalid_type"
}
]
}
}
{
"code": "forbidden",
"message": "You do not have access to this organization.",
"error": "You do not have access to this organization.",
"details": {
"fields": [
{
"field": "amount",
"code": "invalid_type"
}
]
}
}
{
"code": "forbidden",
"message": "You do not have access to this organization.",
"error": "You do not have access to this organization.",
"details": {
"fields": [
{
"field": "amount",
"code": "invalid_type"
}
]
}
}
{
"code": "forbidden",
"message": "You do not have access to this organization.",
"error": "You do not have access to this organization.",
"details": {
"fields": [
{
"field": "amount",
"code": "invalid_type"
}
]
}
}
Transactions
Create transaction
Creates an uncategorized transaction. Grain queues rule and AI categorization after creation. Use Idempotency-Key for duplicate-safe retries: the same key and body return the existing transaction (201); a different body or a deleted original returns 409. To code the transaction yourself, follow with PUT /transactions//coding.
{
"code": "forbidden",
"message": "You do not have access to this organization.",
"error": "You do not have access to this organization.",
"details": {
"fields": [
{
"field": "amount",
"code": "invalid_type"
}
]
}
}
{
"code": "forbidden",
"message": "You do not have access to this organization.",
"error": "You do not have access to this organization.",
"details": {
"fields": [
{
"field": "amount",
"code": "invalid_type"
}
]
}
}
{
"code": "forbidden",
"message": "You do not have access to this organization.",
"error": "You do not have access to this organization.",
"details": {
"fields": [
{
"field": "amount",
"code": "invalid_type"
}
]
}
}
{
"code": "forbidden",
"message": "You do not have access to this organization.",
"error": "You do not have access to this organization.",
"details": {
"fields": [
{
"field": "amount",
"code": "invalid_type"
}
]
}
}
{
"code": "forbidden",
"message": "You do not have access to this organization.",
"error": "You do not have access to this organization.",
"details": {
"fields": [
{
"field": "amount",
"code": "invalid_type"
}
]
}
}
{
"code": "forbidden",
"message": "You do not have access to this organization.",
"error": "You do not have access to this organization.",
"details": {
"fields": [
{
"field": "amount",
"code": "invalid_type"
}
]
}
}
{
"code": "forbidden",
"message": "You do not have access to this organization.",
"error": "You do not have access to this organization.",
"details": {
"fields": [
{
"field": "amount",
"code": "invalid_type"
}
]
}
}
{
"code": "forbidden",
"message": "You do not have access to this organization.",
"error": "You do not have access to this organization.",
"details": {
"fields": [
{
"field": "amount",
"code": "invalid_type"
}
]
}
}
Authorizations
ApiKeyAuthGrainOAuth2BearerAuth
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.
Idempotency-Key
string
Stable key for one transaction create, retained for the lifetime of the organization. Keys are scoped to organization and credential.
Required string length: 1 - 200
Pattern: ^[!-~]+$
Body
application/json
description
string
required
Minimum string length: 1
Example:
"Weekly offering deposit"
amount
number
required
Required range: x >= 0
Example:
4250
date
string<date>
required
Example:
"2026-07-01"
transactionType
enum<string>
required
DEPOSIT records an inflow; the other types record an outflow.
Available options:
DEPOSIT,
WITHDRAWAL,
TRANSFER,
ADJUSTMENT
Example:
"DEPOSIT"
referenceNumber
string
Example:
"DEP-2026-0701"
bankAccountId
string
Connected bank or card feed account.
accountId
string
Ledger cash or bank account for manual transactions.
fundId
string
vendorId
string
is1099Excluded
boolean
externalId
string
Your system's ID for this transaction. Unique within the organization; a duplicate returns 409. Cannot be changed later.
Required string length: 1 - 255
foreignCurrency
string
foreignAmount
number
exchangeRate
number
Response
Created transaction
id
string
required
externalId
string | null
required
Integrator-supplied ID, unique within the organization.
description
string
required
amount
number
required
Always positive. Use direction for the sign.
Required range: x >= 0
direction
enum<string>
required
Available options:
INFLOW,
OUTFLOW
transactionType
enum<string>
required
Available options:
DEPOSIT,
WITHDRAWAL,
TRANSFER,
ADJUSTMENT
date
string<date-time>
required
Calendar day represented as a UTC-midnight ISO timestamp.
referenceNumber
string | null
required
source
enum<string>
required
Available options:
MANUAL,
PLAID,
IMPORT,
PLANNING_CENTER,
PUSHPAY,
TITHELY,
SUBSPLASH,
ROCK_RMS,
RAMP,
DIVVY,
OVERFLOW
reviewStatus
enum<string>
required
Available options:
DRAFT,
PENDING_REVIEW,
PENDING_TRANSFER_MATCH,
PENDING_TRANSFER_CONFIRM,
AUTO_CATEGORIZED,
APPROVED,
POSTED,
REJECTED
isReconciled
boolean
required
is1099Excluded
boolean
required
bankAccount
object | null
required
Connected bank or card feed, when the transaction came from one.
Hide child attributes
bankAccount.id
string
required
bankAccount.name
string
required
bankAccount.mask
string | null
required
bankAccount.accountType
string | null
required
sourceAccount
object | null
required
Ledger cash, bank, or card account the transaction clears through.
Hide child attributes
sourceAccount.id
string
required
sourceAccount.accountNumber
string | null
required
sourceAccount.name
string
required
sourceAccount.accountType
string | null
required
fund
object | null
required
Hide child attributes
fund.id
string
required
fund.name
string
required
fund.fundType
string | null
required
vendor
object | null
required
Hide child attributes
vendor.id
string
required
vendor.name
string
required
dimensions
object[]
required
Header dimensions for the transaction.
Hide child attributes
dimensions.dimensionId
string
required
dimensions.dimensionValueId
string
required
dimensions.dimensionName
string | null
read-only
dimensions.dimensionValueName
string | null
read-only
coding
object
required
Hide child attributes
coding.status
enum<string>
required
UNCATEGORIZED has no journal entry. CATEGORIZED has a draft entry. APPROVED has a posted entry.
Available options:
UNCATEGORIZED,
CATEGORIZED,
APPROVED
coding.journalEntryId
string | null
required
coding.entryNumber
string | null
required
coding.isSplit
boolean
required
coding.lines
object[]
required
Category-side journal lines. The bank or card line is omitted.
Hide child attributes
coding.lines.id
string
required
Journal entry line ID.
coding.lines.account
object | null
required
Hide child attributes
coding.lines.account.id
string
required
coding.lines.account.accountNumber
string | null
required
coding.lines.account.name
string
required
coding.lines.account.accountType
string | null
required
coding.lines.fund
object | null
required
Hide child attributes
coding.lines.fund.id
string
required
coding.lines.fund.name
string
required
coding.lines.fund.fundType
string | null
required
coding.lines.amount
number
required
Allocated amount. Positive values allocate the transaction; negative values offset another line.
coding.lines.memo
string | null
required
coding.lines.dimensions
object[]
required
Hide child attributes
coding.lines.dimensions.dimensionId
string
required
coding.lines.dimensions.dimensionValueId
string
required
coding.lines.dimensions.dimensionName
string | null
read-only
coding.lines.dimensions.dimensionValueName
string | null
read-only
coding.missingRequiredDimensions
object[]
required
Required dimensions that must be assigned before the transaction can be approved.
Hide child attributes
coding.missingRequiredDimensions.dimensionId
string
required
coding.missingRequiredDimensions.dimensionName
string
required
suggestion
object | null
required
Rule or AI coding suggestion awaiting review.
Hide child attributes
suggestion.account
object | null
required
Hide child attributes
suggestion.account.id
string
required
suggestion.account.accountNumber
string | null
required
suggestion.account.name
string
required
suggestion.account.accountType
string | null
required
suggestion.fund
object | null
required
Hide child attributes
suggestion.fund.id
string
required
suggestion.fund.name
string
required
suggestion.fund.fundType
string | null
required
suggestion.confidence
integer | null
required
Required range: 0 <= x <= 100
attachmentCount
integer
required
Required range: x >= 0
canManage
boolean
required
Whether this credential can edit the transaction.
createdAt
string<date-time>
required
updatedAt
string<date-time>
required
Last modified on October 10, 2026
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/schema.json","name":"Grain API","description":"Developer documentation for the Grain church accounting and donor management API.","colors":{"primary":"#03440c","light":"#4A806C","dark":"#3D6B5E"},"logo":{"light":"https://mintcdn.com/grainledger/Jxl-ZANCEY95i3PU/images/grain-wordmark-on-light.svg?fit=max\u0026auto=format\u0026n=Jxl-ZANCEY95i3PU\u0026q=85\u0026s=47f8188964661273a33f4901a311ba81","dark":"https://mintcdn.com/grainledger/Jxl-ZANCEY95i3PU/images/grain-wordmark-on-dark.svg?fit=max\u0026auto=format\u0026n=Jxl-ZANCEY95i3PU\u0026q=85\u0026s=b4689fb4f3c2b42f5e3e251f39b0bf76"},"favicon":"https://mintcdn.com/grainledger/Jxl-ZANCEY95i3PU/images/grain-logomark.svg?fit=max\u0026auto=format\u0026n=Jxl-ZANCEY95i3PU\u0026q=85\u0026s=e53c14afdfadd5aa05ef57a0c8f68985","api":{"openapi":["openapi.json"],"params":{"expanded":"all"},"playground":{"display":"interactive"},"examples":{"defaults":"required","languages":["curl","javascript","python"],"prefill":true,"autogenerate":true},"url":"full"},"search":{"prompt":"Search Grain API docs..."},"seo":{"metatags":{"og:site_name":"Grain API Docs","og:image":"https://grainledger.com/og-image.jpg?v=wheat-field-20260908","og:image:width":"1200","og:image:height":"630","twitter:card":"summary_large_image","twitter:image":"https://grainledger.com/og-image.jpg?v=wheat-field-20260908"},"indexing":"navigable"},"fonts":{"heading":{"family":"DM Sans","weight":600},"body":{"family":"DM Sans","weight":400}},"styling":{"codeblocks":{"theme":{"light":"github-light","dark":"github-dark"}},"latex":false},"integrations":{"posthog":{"apiKey":"phc_nev4txvApsir3qS4dQB5T7JvI46Zl0ZXSQHXpgo6IhD","apiHost":"https://us.i.posthog.com","sessionRecording":false}},"metadata":{"timestamp":true},"navigation":{"global":{"anchors":[{"anchor":"Open app","icon":"https://mintlify.s3.us-west-1.amazonaws.com/grainledger/images/grain-logomark.svg","href":"https://app.grainledger.com"},{"anchor":"Support","icon":"circle-question","href":"https://grainledger.com/support"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"grainledger","hasAudioNarration":false,"actualSubdomain":"grainledger","customDomains":["docs.grainledger.com"],"gitSource":{"type":"github","owner":"grain-ledger","repo":"grain","deployBranch":"main","contentDirectory":"api-docs","isPrivate":true,"mountPath":"","label":"","_id":"6af23ed0ed34cff0851c7334"},"entitlements":{},"buildId":"6aca5e6adf7fb4ef9ef2ce28","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API Reference","count":59},{"language":"default","tag":"Transactions","count":14},{"language":"default","tag":"Getting Started","count":10},{"language":"default","tag":"Households","count":8},{"language":"default","tag":"Core concepts","count":7},{"language":"default","tag":"Bills","count":5},{"language":"default","tag":"Contributions","count":5},{"language":"default","tag":"Donors","count":5},{"language":"default","tag":"Giving Batches","count":5},{"language":"default","tag":"Pledges","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[],"googleFontsInlined":true},"customCss":[]}
{"page":{"pagePath":"api-reference/transactions/create-transaction","slug":"/api-reference/transactions/create-transaction","pageMetadata":{"title":"Create transaction","description":"Creates an uncategorized transaction. Grain queues rule and AI categorization after creation. Use Idempotency-Key for duplicate-safe retries: the same key and body return the existing transaction (201); a different body or a deleted original returns 409. To code the transaction yourself, follow with PUT /transactions/{id}/coding.","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/transactions","href":"/api-reference/transactions/create-transaction","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Creates an uncategorized transaction. Grain queues rule and AI categorization after creation. Use Idempotency-Key for duplicate-safe retries: the same key and body return the existing transaction (201); a different body or a deleted original returns 409. To code the transaction yourself, follow with PUT /transactions/\", \"/coding.\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"codeStyling":{"theme":{"light":"github-light","dark":"github-dark"}},"config":{},"pageMetadata":{"title":"Create transaction","description":"Creates an uncategorized transaction. Grain queues rule and AI categorization after creation. Use Idempotency-Key for duplicate-safe retries: the same key and body return the existing transaction (201); a different body or a deleted original returns 409. To code the transaction yourself, follow with PUT /transactions/{id}/coding.","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/transactions","href":"/api-reference/transactions/create-transaction","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Transactions"],"operationId":"createTransaction","summary":"Create transaction","description":"Creates an uncategorized transaction. Grain queues rule and AI categorization after creation. Use Idempotency-Key for duplicate-safe retries: the same key and body return the existing transaction (201); a different body or a deleted original returns 409. To code the transaction yourself, follow with PUT /transactions/{id}/coding.","parameters":["d4045611-de05-4ca7-9159-5c0b4a832011","3f1be002-5941-468c-96c6-5dfd463f3373"],"requestBody":"69822228-5870-470a-8019-8d522d6773e5","responses":{"201":"732ef1be-144a-48bb-9b10-4f9c720732db","400":"973cfee5-d9ee-462f-9c21-0b22e4c124bd","401":"e5b5f2c6-249c-4ece-96d1-e2cc20263f96","403":"6edff529-01a5-4947-b3a8-3f113d1caad9","404":"4d00cff5-2235-4b5e-86d1-28348ebae818","409":"b99e32a2-823e-4d2d-85ed-704846931dd7","422":"acee1825-9d79-4aeb-abb8-0a0340770e6b","429":"c1866031-368e-4b1c-97ed-4b6a81edf4ce","500":"3b80c67c-1933-4c41-b057-6097bdaba608"},"method":"post","type":"path","servers":["f6713c7b-79dc-4516-9fa4-b80a2e5b565a"],"security":["b13aa5d4-77e1-4461-944f-0c8c2480e9b6","0a4ca29a-fd5e-40fa-afd3-39cd795826a4","5d65a984-a73a-4263-a6ec-edd6bb054d60"],"path":"/api/v1/transactions","baseUrlOptions":["https://api.grainledger.com"],"title":"Create transaction","codeSamples":[],"requestExampleLanguages":["bash","javascript","python"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[{"body.description":"Weekly offering deposit","body.amount":4250,"body.date":"2026-07-01","body.transactionType":"DEPOSIT","body.referenceNumber":"DEP-2026-0701"}],"urlDisplay":"full"},"dependencies":{"parameters":{"d4045611-de05-4ca7-9159-5c0b4a832011":{"name":"X-Organization-Id","in":"header","required":false,"schema":{"type":"string","isRequired":false,"description":"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.","uniqueKey":"","typeLabel":"string"},"description":"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.","example":"cm123abc456def"},"3f1be002-5941-468c-96c6-5dfd463f3373":{"name":"Idempotency-Key","in":"header","required":false,"description":"Stable key for one transaction create, retained for the lifetime of the organization. Keys are scoped to organization and credential.","schema":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[!-~]+$","isRequired":false,"description":"Stable key for one transaction create, retained for the lifetime of the organization. Keys are scoped to organization and credential.","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["description","amount","date","transactionType"],"properties":{"description":{"type":"string","minLength":1,"example":"Weekly offering deposit","isRequired":true,"uniqueKey":"description","typeLabel":"string"},"amount":{"type":"number","minimum":0,"example":4250,"isRequired":true,"uniqueKey":"amount","typeLabel":"number"},"date":{"type":"string","format":"date","example":"2026-07-01","isRequired":true,"uniqueKey":"date","typeLabel":"string\u003cdate>"},"transactionType":{"type":"string","enum":["DEPOSIT","WITHDRAWAL","TRANSFER","ADJUSTMENT"],"example":"DEPOSIT","description":"DEPOSIT records an inflow; the other types record an outflow.","isRequired":true,"uniqueKey":"transactionType","typeLabel":"enum\u003cstring>"},"referenceNumber":{"type":"string","example":"DEP-2026-0701","uniqueKey":"referenceNumber","typeLabel":"string"},"bankAccountId":{"type":"string","description":"Connected bank or card feed account.","uniqueKey":"bankAccountId","typeLabel":"string"},"accountId":{"type":"string","description":"Ledger cash or bank account for manual transactions.","uniqueKey":"accountId","typeLabel":"string"},"fundId":{"type":"string","uniqueKey":"fundId","typeLabel":"string"},"vendorId":{"type":"string","uniqueKey":"vendorId","typeLabel":"string"},"is1099Excluded":{"type":"boolean","uniqueKey":"is1099Excluded","typeLabel":"boolean"},"externalId":{"type":"string","minLength":1,"maxLength":255,"description":"Your system's ID for this transaction. Unique within the organization; a duplicate returns 409. Cannot be changed later.","uniqueKey":"externalId","typeLabel":"string"},"foreignCurrency":{"type":"string","uniqueKey":"foreignCurrency","typeLabel":"string"},"foreignAmount":{"type":"number","uniqueKey":"foreignAmount","typeLabel":"number"},"exchangeRate":{"type":"number","uniqueKey":"exchangeRate","typeLabel":"number"}},"uniqueKey":"","typeLabel":"object"},"examples":{"deposit":{"title":"deposit","value":{"description":"Weekly offering deposit","amount":4250,"date":"2026-07-01","transactionType":"DEPOSIT","referenceNumber":"DEP-2026-0701"}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"732ef1be-144a-48bb-9b10-4f9c720732db":{"headers":{"X-Request-Id":{"description":"Server-generated ID linking this request to API activity and audit records.","schema":{"type":"string","format":"uuid"}}},"description":"Created transaction","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["id","externalId","description","amount","direction","transactionType","date","referenceNumber","source","reviewStatus","isReconciled","is1099Excluded","bankAccount","sourceAccount","fund","vendor","dimensions","coding","suggestion","attachmentCount","canManage","createdAt","updatedAt"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"externalId":{"oneOf":[{"type":"string","description":"Integrator-supplied ID, unique within the organization.","isRequired":true,"uniqueKey":"externalId.oneOf.0","typeLabel":"string"},{"type":"null","description":"Integrator-supplied ID, unique within the organization.","isRequired":true,"uniqueKey":"externalId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"externalId","typeLabel":"string | null"},"description":{"type":"string","isRequired":true,"uniqueKey":"description","typeLabel":"string"},"amount":{"type":"number","minimum":0,"description":"Always positive. Use direction for the sign.","isRequired":true,"uniqueKey":"amount","typeLabel":"number"},"direction":{"type":"string","enum":["INFLOW","OUTFLOW"],"isRequired":true,"uniqueKey":"direction","typeLabel":"enum\u003cstring>"},"transactionType":{"type":"string","enum":["DEPOSIT","WITHDRAWAL","TRANSFER","ADJUSTMENT"],"isRequired":true,"uniqueKey":"transactionType","typeLabel":"enum\u003cstring>"},"date":{"type":"string","format":"date-time","description":"Calendar day represented as a UTC-midnight ISO timestamp.","isRequired":true,"uniqueKey":"date","typeLabel":"string\u003cdate-time>"},"referenceNumber":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"referenceNumber.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"referenceNumber.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"referenceNumber","typeLabel":"string | null"},"source":{"type":"string","enum":["MANUAL","PLAID","IMPORT","PLANNING_CENTER","PUSHPAY","TITHELY","SUBSPLASH","ROCK_RMS","RAMP","DIVVY","OVERFLOW"],"isRequired":true,"uniqueKey":"source","typeLabel":"enum\u003cstring>"},"reviewStatus":{"type":"string","enum":["DRAFT","PENDING_REVIEW","PENDING_TRANSFER_MATCH","PENDING_TRANSFER_CONFIRM","AUTO_CATEGORIZED","APPROVED","POSTED","REJECTED"],"isRequired":true,"uniqueKey":"reviewStatus","typeLabel":"enum\u003cstring>"},"isReconciled":{"type":"boolean","isRequired":true,"uniqueKey":"isReconciled","typeLabel":"boolean"},"is1099Excluded":{"type":"boolean","isRequired":true,"uniqueKey":"is1099Excluded","typeLabel":"boolean"},"bankAccount":{"oneOf":[{"type":"object","additionalProperties":false,"required":["id","name","mask","accountType"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"bankAccount.oneOf.0.id","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"bankAccount.oneOf.0.name","typeLabel":"string"},"mask":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"bankAccount.oneOf.0.mask.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"bankAccount.oneOf.0.mask.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"bankAccount.oneOf.0.mask","typeLabel":"string | null"},"accountType":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"bankAccount.oneOf.0.accountType.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"bankAccount.oneOf.0.accountType.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"bankAccount.oneOf.0.accountType","typeLabel":"string | null"}},"description":"Connected bank or card feed, when the transaction came from one.","isRequired":true,"uniqueKey":"bankAccount.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":false,"required":["id","name","mask","accountType"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"mask":{"oneOf":[{"type":"string"},{"type":"null"}]},"accountType":{"oneOf":[{"type":"string"},{"type":"null"}]}},"description":"Connected bank or card feed, when the transaction came from one.","isRequired":true,"uniqueKey":"bankAccount.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"bankAccount","typeLabel":"object | null"},"sourceAccount":{"oneOf":[{"type":"object","additionalProperties":false,"required":["id","accountNumber","name","accountType"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"sourceAccount.oneOf.0.id","typeLabel":"string"},"accountNumber":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"sourceAccount.oneOf.0.accountNumber.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"sourceAccount.oneOf.0.accountNumber.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"sourceAccount.oneOf.0.accountNumber","typeLabel":"string | null"},"name":{"type":"string","isRequired":true,"uniqueKey":"sourceAccount.oneOf.0.name","typeLabel":"string"},"accountType":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"sourceAccount.oneOf.0.accountType.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"sourceAccount.oneOf.0.accountType.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"sourceAccount.oneOf.0.accountType","typeLabel":"string | null"}},"description":"Ledger cash, bank, or card account the transaction clears through.","isRequired":true,"uniqueKey":"sourceAccount.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":false,"required":["id","accountNumber","name","accountType"],"properties":{"id":{"type":"string"},"accountNumber":{"oneOf":[{"type":"string"},{"type":"null"}]},"name":{"type":"string"},"accountType":{"oneOf":[{"type":"string"},{"type":"null"}]}},"description":"Ledger cash, bank, or card account the transaction clears through.","isRequired":true,"uniqueKey":"sourceAccount.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"sourceAccount","typeLabel":"object | null"},"fund":{"oneOf":[{"type":"object","additionalProperties":false,"required":["id","name","fundType"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"fund.oneOf.0.id","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"fund.oneOf.0.name","typeLabel":"string"},"fundType":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"fund.oneOf.0.fundType.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"fund.oneOf.0.fundType.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"fund.oneOf.0.fundType","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"fund.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":false,"required":["id","name","fundType"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"fundType":{"oneOf":[{"type":"string"},{"type":"null"}]}},"isRequired":true,"uniqueKey":"fund.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"fund","typeLabel":"object | null"},"vendor":{"oneOf":[{"type":"object","additionalProperties":false,"required":["id","name"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"vendor.oneOf.0.id","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"vendor.oneOf.0.name","typeLabel":"string"}},"isRequired":true,"uniqueKey":"vendor.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":false,"required":["id","name"],"properties":{"id":{"type":"string"},"name":{"type":"string"}},"isRequired":true,"uniqueKey":"vendor.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"vendor","typeLabel":"object | null"},"dimensions":{"type":"array","description":"Header dimensions for the transaction.","items":{"type":"object","additionalProperties":false,"required":["dimensionId","dimensionValueId"],"properties":{"dimensionId":{"type":"string","isRequired":true,"uniqueKey":"dimensions.items.[INDEX].dimensionId","typeLabel":"string"},"dimensionValueId":{"type":"string","isRequired":true,"uniqueKey":"dimensions.items.[INDEX].dimensionValueId","typeLabel":"string"},"dimensionName":{"oneOf":[{"type":"string","readOnly":true,"uniqueKey":"dimensions.items.[INDEX].dimensionName.oneOf.0","typeLabel":"string"},{"type":"null","readOnly":true,"uniqueKey":"dimensions.items.[INDEX].dimensionName.oneOf.1","typeLabel":"null"}],"uniqueKey":"dimensions.items.[INDEX].dimensionName","typeLabel":"string | null"},"dimensionValueName":{"oneOf":[{"type":"string","readOnly":true,"uniqueKey":"dimensions.items.[INDEX].dimensionValueName.oneOf.0","typeLabel":"string"},{"type":"null","readOnly":true,"uniqueKey":"dimensions.items.[INDEX].dimensionValueName.oneOf.1","typeLabel":"null"}],"uniqueKey":"dimensions.items.[INDEX].dimensionValueName","typeLabel":"string | null"}},"uniqueKey":"dimensions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"dimensions","typeLabel":"object[]"},"coding":{"type":"object","additionalProperties":false,"required":["status","journalEntryId","entryNumber","isSplit","lines","missingRequiredDimensions"],"properties":{"status":{"type":"string","enum":["UNCATEGORIZED","CATEGORIZED","APPROVED"],"description":"UNCATEGORIZED has no journal entry. CATEGORIZED has a draft entry. APPROVED has a posted entry.","isRequired":true,"uniqueKey":"coding.status","typeLabel":"enum\u003cstring>"},"journalEntryId":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"coding.journalEntryId.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"coding.journalEntryId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"coding.journalEntryId","typeLabel":"string | null"},"entryNumber":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"coding.entryNumber.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"coding.entryNumber.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"coding.entryNumber","typeLabel":"string | null"},"isSplit":{"type":"boolean","isRequired":true,"uniqueKey":"coding.isSplit","typeLabel":"boolean"},"lines":{"type":"array","description":"Category-side journal lines. The bank or card line is omitted.","items":{"type":"object","additionalProperties":false,"required":["id","account","fund","amount","memo","dimensions"],"properties":{"id":{"type":"string","description":"Journal entry line ID.","isRequired":true,"uniqueKey":"coding.lines.items.[INDEX].id","typeLabel":"string"},"account":{"oneOf":[{"type":"object","additionalProperties":false,"required":["id","accountNumber","name","accountType"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"coding.lines.items.[INDEX].account.oneOf.0.id","typeLabel":"string"},"accountNumber":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"coding.lines.items.[INDEX].account.oneOf.0.accountNumber.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"coding.lines.items.[INDEX].account.oneOf.0.accountNumber.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"coding.lines.items.[INDEX].account.oneOf.0.accountNumber","typeLabel":"string | null"},"name":{"type":"string","isRequired":true,"uniqueKey":"coding.lines.items.[INDEX].account.oneOf.0.name","typeLabel":"string"},"accountType":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"coding.lines.items.[INDEX].account.oneOf.0.accountType.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"coding.lines.items.[INDEX].account.oneOf.0.accountType.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"coding.lines.items.[INDEX].account.oneOf.0.accountType","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"coding.lines.items.[INDEX].account.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":false,"required":["id","accountNumber","name","accountType"],"properties":{"id":{"type":"string"},"accountNumber":{"oneOf":[{"type":"string"},{"type":"null"}]},"name":{"type":"string"},"accountType":{"oneOf":[{"type":"string"},{"type":"null"}]}},"isRequired":true,"uniqueKey":"coding.lines.items.[INDEX].account.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"coding.lines.items.[INDEX].account","typeLabel":"object | null"},"fund":{"oneOf":[{"type":"object","additionalProperties":false,"required":["id","name","fundType"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"coding.lines.items.[INDEX].fund.oneOf.0.id","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"coding.lines.items.[INDEX].fund.oneOf.0.name","typeLabel":"string"},"fundType":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"coding.lines.items.[INDEX].fund.oneOf.0.fundType.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"coding.lines.items.[INDEX].fund.oneOf.0.fundType.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"coding.lines.items.[INDEX].fund.oneOf.0.fundType","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"coding.lines.items.[INDEX].fund.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":false,"required":["id","name","fundType"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"fundType":{"oneOf":[{"type":"string"},{"type":"null"}]}},"isRequired":true,"uniqueKey":"coding.lines.items.[INDEX].fund.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"coding.lines.items.[INDEX].fund","typeLabel":"object | null"},"amount":{"type":"number","description":"Allocated amount. Positive values allocate the transaction; negative values offset another line.","isRequired":true,"uniqueKey":"coding.lines.items.[INDEX].amount","typeLabel":"number"},"memo":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"coding.lines.items.[INDEX].memo.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"coding.lines.items.[INDEX].memo.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"coding.lines.items.[INDEX].memo","typeLabel":"string | null"},"dimensions":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["dimensionId","dimensionValueId"],"properties":{"dimensionId":{"type":"string","isRequired":true,"uniqueKey":"coding.lines.items.[INDEX].dimensions.items.[INDEX].dimensionId","typeLabel":"string"},"dimensionValueId":{"type":"string","isRequired":true,"uniqueKey":"coding.lines.items.[INDEX].dimensions.items.[INDEX].dimensionValueId","typeLabel":"string"},"dimensionName":{"oneOf":[{"type":"string","readOnly":true,"uniqueKey":"coding.lines.items.[INDEX].dimensions.items.[INDEX].dimensionName.oneOf.0","typeLabel":"string"},{"type":"null","readOnly":true,"uniqueKey":"coding.lines.items.[INDEX].dimensions.items.[INDEX].dimensionName.oneOf.1","typeLabel":"null"}],"uniqueKey":"coding.lines.items.[INDEX].dimensions.items.[INDEX].dimensionName","typeLabel":"string | null"},"dimensionValueName":{"oneOf":[{"type":"string","readOnly":true,"uniqueKey":"coding.lines.items.[INDEX].dimensions.items.[INDEX].dimensionValueName.oneOf.0","typeLabel":"string"},{"type":"null","readOnly":true,"uniqueKey":"coding.lines.items.[INDEX].dimensions.items.[INDEX].dimensionValueName.oneOf.1","typeLabel":"null"}],"uniqueKey":"coding.lines.items.[INDEX].dimensions.items.[INDEX].dimensionValueName","typeLabel":"string | null"}},"uniqueKey":"coding.lines.items.[INDEX].dimensions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"coding.lines.items.[INDEX].dimensions","typeLabel":"object[]"}},"uniqueKey":"coding.lines.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"coding.lines","typeLabel":"object[]"},"missingRequiredDimensions":{"type":"array","description":"Required dimensions that must be assigned before the transaction can be approved.","items":{"type":"object","additionalProperties":false,"required":["dimensionId","dimensionName"],"properties":{"dimensionId":{"type":"string","isRequired":true,"uniqueKey":"coding.missingRequiredDimensions.items.[INDEX].dimensionId","typeLabel":"string"},"dimensionName":{"type":"string","isRequired":true,"uniqueKey":"coding.missingRequiredDimensions.items.[INDEX].dimensionName","typeLabel":"string"}},"uniqueKey":"coding.missingRequiredDimensions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"coding.missingRequiredDimensions","typeLabel":"object[]"}},"isRequired":true,"uniqueKey":"coding","typeLabel":"object"},"suggestion":{"oneOf":[{"type":"object","additionalProperties":false,"required":["account","fund","confidence"],"description":"Rule or AI coding suggestion awaiting review.","properties":{"account":{"oneOf":[{"type":"object","additionalProperties":false,"required":["id","accountNumber","name","accountType"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"suggestion.oneOf.0.account.oneOf.0.id","typeLabel":"string"},"accountNumber":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"suggestion.oneOf.0.account.oneOf.0.accountNumber.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"suggestion.oneOf.0.account.oneOf.0.accountNumber.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"suggestion.oneOf.0.account.oneOf.0.accountNumber","typeLabel":"string | null"},"name":{"type":"string","isRequired":true,"uniqueKey":"suggestion.oneOf.0.account.oneOf.0.name","typeLabel":"string"},"accountType":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"suggestion.oneOf.0.account.oneOf.0.accountType.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"suggestion.oneOf.0.account.oneOf.0.accountType.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"suggestion.oneOf.0.account.oneOf.0.accountType","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"suggestion.oneOf.0.account.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":false,"required":["id","accountNumber","name","accountType"],"properties":{"id":{"type":"string"},"accountNumber":{"oneOf":[{"type":"string"},{"type":"null"}]},"name":{"type":"string"},"accountType":{"oneOf":[{"type":"string"},{"type":"null"}]}},"isRequired":true,"uniqueKey":"suggestion.oneOf.0.account.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"suggestion.oneOf.0.account","typeLabel":"object | null"},"fund":{"oneOf":[{"type":"object","additionalProperties":false,"required":["id","name","fundType"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"suggestion.oneOf.0.fund.oneOf.0.id","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"suggestion.oneOf.0.fund.oneOf.0.name","typeLabel":"string"},"fundType":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"suggestion.oneOf.0.fund.oneOf.0.fundType.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"suggestion.oneOf.0.fund.oneOf.0.fundType.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"suggestion.oneOf.0.fund.oneOf.0.fundType","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"suggestion.oneOf.0.fund.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":false,"required":["id","name","fundType"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"fundType":{"oneOf":[{"type":"string"},{"type":"null"}]}},"isRequired":true,"uniqueKey":"suggestion.oneOf.0.fund.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"suggestion.oneOf.0.fund","typeLabel":"object | null"},"confidence":{"oneOf":[{"type":"integer","minimum":0,"maximum":100,"isRequired":true,"uniqueKey":"suggestion.oneOf.0.confidence.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":0,"maximum":100,"isRequired":true,"uniqueKey":"suggestion.oneOf.0.confidence.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"suggestion.oneOf.0.confidence","typeLabel":"integer | null"}},"isRequired":true,"uniqueKey":"suggestion.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":false,"required":["account","fund","confidence"],"description":"Rule or AI coding suggestion awaiting review.","properties":{"account":{"oneOf":[{"type":"object","additionalProperties":false,"required":["id","accountNumber","name","accountType"],"properties":{"id":{"type":"string"},"accountNumber":{"oneOf":[{"type":"string"},{"type":"null"}]},"name":{"type":"string"},"accountType":{"oneOf":[{"type":"string"},{"type":"null"}]}}},{"type":"null","additionalProperties":false,"required":["id","accountNumber","name","accountType"],"properties":{"id":{"type":"string"},"accountNumber":{"oneOf":[{"type":"string"},{"type":"null"}]},"name":{"type":"string"},"accountType":{"oneOf":[{"type":"string"},{"type":"null"}]}}}]},"fund":{"oneOf":[{"type":"object","additionalProperties":false,"required":["id","name","fundType"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"fundType":{"oneOf":[{"type":"string"},{"type":"null"}]}}},{"type":"null","additionalProperties":false,"required":["id","name","fundType"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"fundType":{"oneOf":[{"type":"string"},{"type":"null"}]}}}]},"confidence":{"oneOf":[{"type":"integer","minimum":0,"maximum":100},{"type":"null","minimum":0,"maximum":100}]}},"isRequired":true,"uniqueKey":"suggestion.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"suggestion","typeLabel":"object | null"},"attachmentCount":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"attachmentCount","typeLabel":"integer"},"canManage":{"type":"boolean","description":"Whether this credential can edit the transaction.","isRequired":true,"uniqueKey":"canManage","typeLabel":"boolean"},"createdAt":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"createdAt","typeLabel":"string\u003cdate-time>"},"updatedAt":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"updatedAt","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"\u003cstring>","externalId":"\u003cstring>","description":"\u003cstring>","amount":1,"direction":"INFLOW","transactionType":"DEPOSIT","date":"2023-11-07T05:31:56Z","referenceNumber":"\u003cstring>","source":"MANUAL","reviewStatus":"DRAFT","isReconciled":true,"is1099Excluded":true,"bankAccount":{"id":"\u003cstring>","name":"\u003cstring>","mask":"\u003cstring>","accountType":"\u003cstring>"},"sourceAccount":{"id":"\u003cstring>","accountNumber":"\u003cstring>","name":"\u003cstring>","accountType":"\u003cstring>"},"fund":{"id":"\u003cstring>","name":"\u003cstring>","fundType":"\u003cstring>"},"vendor":{"id":"\u003cstring>","name":"\u003cstring>"},"dimensions":[{"dimensionId":"\u003cstring>","dimensionValueId":"\u003cstring>","dimensionName":"\u003cstring>","dimensionValueName":"\u003cstring>"}],"coding":{"status":"UNCATEGORIZED","journalEntryId":"\u003cstring>","entryNumber":"\u003cstring>","isSplit":true,"lines":[{"id":"\u003cstring>","account":{"id":"\u003cstring>","accountNumber":"\u003cstring>","name":"\u003cstring>","accountType":"\u003cstring>"},"fund":{"id":"\u003cstring>","name":"\u003cstring>","fundType":"\u003cstring>"},"amount":123,"memo":"\u003cstring>","dimensions":[{"dimensionId":"\u003cstring>","dimensionValueId":"\u003cstring>","dimensionName":"\u003cstring>","dimensionValueName":"\u003cstring>"}]}],"missingRequiredDimensions":[{"dimensionId":"\u003cstring>","dimensionName":"\u003cstring>"}]},"suggestion":{"account":{"id":"\u003cstring>","accountNumber":"\u003cstring>","name":"\u003cstring>","accountType":"\u003cstring>"},"fund":{"id":"\u003cstring>","name":"\u003cstring>","fundType":"\u003cstring>"},"confidence":50},"attachmentCount":1,"canManage":true,"createdAt":"2023-11-07T05:31:56Z","updatedAt":"2023-11-07T05:31:56Z"}}},"exampleType":"generated"}},"exampleType":"generated"},"973cfee5-d9ee-462f-9c21-0b22e4c124bd":{"headers":{"X-Request-Id":{"description":"Server-generated ID linking this request to API activity and audit records.","schema":{"type":"string","format":"uuid"}}},"description":"Bad request (missing header or invalid input)","content":{"application/json":{"schema":{"type":"object","description":"Every error response is valid JSON with this shape. The HTTP status code carries the outcome; `code` is a stable machine-readable form of it.","required":["code","message"],"properties":{"code":{"type":"string","enum":["bad_request","unauthorized","forbidden","not_found","conflict","unprocessable_entity","payload_too_large","rate_limited","internal_server_error"],"example":"forbidden","isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","example":"You do not have access to this organization.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"error":{"type":"string","deprecated":true,"description":"Deprecated alias for `message`. Read `message` instead.","example":"You do not have access to this organization.","uniqueKey":"error","typeLabel":"string"},"details":{"type":"object","description":"Present for schema validation failures. Contains safe top-level field names and validation codes, never submitted values.","properties":{"fields":{"type":"array","maxItems":20,"items":{"type":"object","required":["field","code"],"properties":{"field":{"type":"string","example":"amount","isRequired":true,"uniqueKey":"details.fields.items.[INDEX].field","typeLabel":"string"},"code":{"type":"string","example":"invalid_type","isRequired":true,"uniqueKey":"details.fields.items.[INDEX].code","typeLabel":"string"}},"uniqueKey":"details.fields.items.[INDEX]","typeLabel":"object"},"uniqueKey":"details.fields","typeLabel":"object[]"}},"uniqueKey":"details","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"forbidden","message":"You do not have access to this organization.","error":"You do not have access to this organization.","details":{"fields":[{"field":"amount","code":"invalid_type"}]}}}},"exampleType":"generated"}},"exampleType":"generated"},"e5b5f2c6-249c-4ece-96d1-e2cc20263f96":{"headers":{"X-Request-Id":{"description":"Server-generated ID linking this request to API activity and audit records.","schema":{"type":"string","format":"uuid"}}},"description":"Unauthorized (missing or invalid Bearer token)","content":{"application/json":{"schema":{"type":"object","description":"Every error response is valid JSON with this shape. The HTTP status code carries the outcome; `code` is a stable machine-readable form of it.","required":["code","message"],"properties":{"code":{"type":"string","enum":["bad_request","unauthorized","forbidden","not_found","conflict","unprocessable_entity","payload_too_large","rate_limited","internal_server_error"],"example":"forbidden","isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","example":"You do not have access to this organization.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"error":{"type":"string","deprecated":true,"description":"Deprecated alias for `message`. Read `message` instead.","example":"You do not have access to this organization.","uniqueKey":"error","typeLabel":"string"},"details":{"type":"object","description":"Present for schema validation failures. Contains safe top-level field names and validation codes, never submitted values.","properties":{"fields":{"type":"array","maxItems":20,"items":{"type":"object","required":["field","code"],"properties":{"field":{"type":"string","example":"amount","isRequired":true,"uniqueKey":"details.fields.items.[INDEX].field","typeLabel":"string"},"code":{"type":"string","example":"invalid_type","isRequired":true,"uniqueKey":"details.fields.items.[INDEX].code","typeLabel":"string"}},"uniqueKey":"details.fields.items.[INDEX]","typeLabel":"object"},"uniqueKey":"details.fields","typeLabel":"object[]"}},"uniqueKey":"details","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"forbidden","message":"You do not have access to this organization.","error":"You do not have access to this organization.","details":{"fields":[{"field":"amount","code":"invalid_type"}]}}}},"exampleType":"generated"}},"exampleType":"generated"},"6edff529-01a5-4947-b3a8-3f113d1caad9":{"headers":{"X-Request-Id":{"description":"Server-generated ID linking this request to API activity and audit records.","schema":{"type":"string","format":"uuid"}}},"description":"Forbidden (no access to organization or action)","content":{"application/json":{"schema":{"type":"object","description":"Every error response is valid JSON with this shape. The HTTP status code carries the outcome; `code` is a stable machine-readable form of it.","required":["code","message"],"properties":{"code":{"type":"string","enum":["bad_request","unauthorized","forbidden","not_found","conflict","unprocessable_entity","payload_too_large","rate_limited","internal_server_error"],"example":"forbidden","isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","example":"You do not have access to this organization.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"error":{"type":"string","deprecated":true,"description":"Deprecated alias for `message`. Read `message` instead.","example":"You do not have access to this organization.","uniqueKey":"error","typeLabel":"string"},"details":{"type":"object","description":"Present for schema validation failures. Contains safe top-level field names and validation codes, never submitted values.","properties":{"fields":{"type":"array","maxItems":20,"items":{"type":"object","required":["field","code"],"properties":{"field":{"type":"string","example":"amount","isRequired":true,"uniqueKey":"details.fields.items.[INDEX].field","typeLabel":"string"},"code":{"type":"string","example":"invalid_type","isRequired":true,"uniqueKey":"details.fields.items.[INDEX].code","typeLabel":"string"}},"uniqueKey":"details.fields.items.[INDEX]","typeLabel":"object"},"uniqueKey":"details.fields","typeLabel":"object[]"}},"uniqueKey":"details","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"forbidden","message":"You do not have access to this organization.","error":"You do not have access to this organization.","details":{"fields":[{"field":"amount","code":"invalid_type"}]}}}},"exampleType":"generated"}},"exampleType":"generated"},"4d00cff5-2235-4b5e-86d1-28348ebae818":{"description":"Resource not found","content":{"application/json":{"schema":{"type":"object","description":"Every error response is valid JSON with this shape. The HTTP status code carries the outcome; `code` is a stable machine-readable form of it.","required":["code","message"],"properties":{"code":{"type":"string","enum":["bad_request","unauthorized","forbidden","not_found","conflict","unprocessable_entity","payload_too_large","rate_limited","internal_server_error"],"example":"forbidden","isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","example":"You do not have access to this organization.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"error":{"type":"string","deprecated":true,"description":"Deprecated alias for `message`. Read `message` instead.","example":"You do not have access to this organization.","uniqueKey":"error","typeLabel":"string"},"details":{"type":"object","description":"Present for schema validation failures. Contains safe top-level field names and validation codes, never submitted values.","properties":{"fields":{"type":"array","maxItems":20,"items":{"type":"object","required":["field","code"],"properties":{"field":{"type":"string","example":"amount","isRequired":true,"uniqueKey":"details.fields.items.[INDEX].field","typeLabel":"string"},"code":{"type":"string","example":"invalid_type","isRequired":true,"uniqueKey":"details.fields.items.[INDEX].code","typeLabel":"string"}},"uniqueKey":"details.fields.items.[INDEX]","typeLabel":"object"},"uniqueKey":"details.fields","typeLabel":"object[]"}},"uniqueKey":"details","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"forbidden","message":"You do not have access to this organization.","error":"You do not have access to this organization.","details":{"fields":[{"field":"amount","code":"invalid_type"}]}}}},"exampleType":"generated"}},"headers":{"X-Request-Id":{"description":"Server-generated ID linking this request to API activity and audit records.","schema":{"type":"string","format":"uuid"}}},"exampleType":"generated"},"b99e32a2-823e-4d2d-85ed-704846931dd7":{"headers":{"X-Request-Id":{"description":"Server-generated ID linking this request to API activity and audit records.","schema":{"type":"string","format":"uuid"}}},"description":"Conflict (duplicate, cross-resource ownership conflict, concurrent change, or accounting-frozen resource)","content":{"application/json":{"schema":{"type":"object","description":"Every error response is valid JSON with this shape. The HTTP status code carries the outcome; `code` is a stable machine-readable form of it.","required":["code","message"],"properties":{"code":{"type":"string","enum":["bad_request","unauthorized","forbidden","not_found","conflict","unprocessable_entity","payload_too_large","rate_limited","internal_server_error"],"example":"forbidden","isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","example":"You do not have access to this organization.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"error":{"type":"string","deprecated":true,"description":"Deprecated alias for `message`. Read `message` instead.","example":"You do not have access to this organization.","uniqueKey":"error","typeLabel":"string"},"details":{"type":"object","description":"Present for schema validation failures. Contains safe top-level field names and validation codes, never submitted values.","properties":{"fields":{"type":"array","maxItems":20,"items":{"type":"object","required":["field","code"],"properties":{"field":{"type":"string","example":"amount","isRequired":true,"uniqueKey":"details.fields.items.[INDEX].field","typeLabel":"string"},"code":{"type":"string","example":"invalid_type","isRequired":true,"uniqueKey":"details.fields.items.[INDEX].code","typeLabel":"string"}},"uniqueKey":"details.fields.items.[INDEX]","typeLabel":"object"},"uniqueKey":"details.fields","typeLabel":"object[]"}},"uniqueKey":"details","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"forbidden","message":"You do not have access to this organization.","error":"You do not have access to this organization.","details":{"fields":[{"field":"amount","code":"invalid_type"}]}}}},"exampleType":"generated"}},"exampleType":"generated"},"acee1825-9d79-4aeb-abb8-0a0340770e6b":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","description":"Every error response is valid JSON with this shape. The HTTP status code carries the outcome; `code` is a stable machine-readable form of it.","required":["code","message"],"properties":{"code":{"type":"string","enum":["bad_request","unauthorized","forbidden","not_found","conflict","unprocessable_entity","payload_too_large","rate_limited","internal_server_error"],"example":"forbidden","isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","example":"You do not have access to this organization.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"error":{"type":"string","deprecated":true,"description":"Deprecated alias for `message`. Read `message` instead.","example":"You do not have access to this organization.","uniqueKey":"error","typeLabel":"string"},"details":{"type":"object","description":"Present for schema validation failures. Contains safe top-level field names and validation codes, never submitted values.","properties":{"fields":{"type":"array","maxItems":20,"items":{"type":"object","required":["field","code"],"properties":{"field":{"type":"string","example":"amount","isRequired":true,"uniqueKey":"details.fields.items.[INDEX].field","typeLabel":"string"},"code":{"type":"string","example":"invalid_type","isRequired":true,"uniqueKey":"details.fields.items.[INDEX].code","typeLabel":"string"}},"uniqueKey":"details.fields.items.[INDEX]","typeLabel":"object"},"uniqueKey":"details.fields","typeLabel":"object[]"}},"uniqueKey":"details","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"forbidden","message":"You do not have access to this organization.","error":"You do not have access to this organization.","details":{"fields":[{"field":"amount","code":"invalid_type"}]}}}},"exampleType":"generated"}},"headers":{"X-Request-Id":{"description":"Server-generated ID linking this request to API activity and audit records.","schema":{"type":"string","format":"uuid"}}},"exampleType":"generated"},"c1866031-368e-4b1c-97ed-4b6a81edf4ce":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"type":"object","description":"Every error response is valid JSON with this shape. The HTTP status code carries the outcome; `code` is a stable machine-readable form of it.","required":["code","message"],"properties":{"code":{"type":"string","enum":["bad_request","unauthorized","forbidden","not_found","conflict","unprocessable_entity","payload_too_large","rate_limited","internal_server_error"],"example":"forbidden","isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","example":"You do not have access to this organization.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"error":{"type":"string","deprecated":true,"description":"Deprecated alias for `message`. Read `message` instead.","example":"You do not have access to this organization.","uniqueKey":"error","typeLabel":"string"},"details":{"type":"object","description":"Present for schema validation failures. Contains safe top-level field names and validation codes, never submitted values.","properties":{"fields":{"type":"array","maxItems":20,"items":{"type":"object","required":["field","code"],"properties":{"field":{"type":"string","example":"amount","isRequired":true,"uniqueKey":"details.fields.items.[INDEX].field","typeLabel":"string"},"code":{"type":"string","example":"invalid_type","isRequired":true,"uniqueKey":"details.fields.items.[INDEX].code","typeLabel":"string"}},"uniqueKey":"details.fields.items.[INDEX]","typeLabel":"object"},"uniqueKey":"details.fields","typeLabel":"object[]"}},"uniqueKey":"details","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"forbidden","message":"You do not have access to this organization.","error":"You do not have access to this organization.","details":{"fields":[{"field":"amount","code":"invalid_type"}]}}}},"exampleType":"generated"}},"headers":{"X-Request-Id":{"description":"Server-generated ID linking this request to API activity and audit records.","schema":{"type":"string","format":"uuid"}}},"exampleType":"generated"},"3b80c67c-1933-4c41-b057-6097bdaba608":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","description":"Every error response is valid JSON with this shape. The HTTP status code carries the outcome; `code` is a stable machine-readable form of it.","required":["code","message"],"properties":{"code":{"type":"string","enum":["bad_request","unauthorized","forbidden","not_found","conflict","unprocessable_entity","payload_too_large","rate_limited","internal_server_error"],"example":"forbidden","isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","example":"You do not have access to this organization.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"error":{"type":"string","deprecated":true,"description":"Deprecated alias for `message`. Read `message` instead.","example":"You do not have access to this organization.","uniqueKey":"error","typeLabel":"string"},"details":{"type":"object","description":"Present for schema validation failures. Contains safe top-level field names and validation codes, never submitted values.","properties":{"fields":{"type":"array","maxItems":20,"items":{"type":"object","required":["field","code"],"properties":{"field":{"type":"string","example":"amount","isRequired":true,"uniqueKey":"details.fields.items.[INDEX].field","typeLabel":"string"},"code":{"type":"string","example":"invalid_type","isRequired":true,"uniqueKey":"details.fields.items.[INDEX].code","typeLabel":"string"}},"uniqueKey":"details.fields.items.[INDEX]","typeLabel":"object"},"uniqueKey":"details.fields","typeLabel":"object[]"}},"uniqueKey":"details","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"forbidden","message":"You do not have access to this organization.","error":"You do not have access to this organization.","details":{"fields":[{"field":"amount","code":"invalid_type"}]}}}},"exampleType":"generated"}},"headers":{"X-Request-Id":{"description":"Server-generated ID linking this request to API activity and audit records.","schema":{"type":"string","format":"uuid"}}},"exampleType":"generated"}},"security":{"b13aa5d4-77e1-4461-944f-0c8c2480e9b6":{"ApiKeyAuth":{"type":"http","scheme":"bearer","bearerFormat":"grain_live_… or grain_test_…","description":"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.","scopes":[],"schemeName":"ApiKeyAuth"}},"0a4ca29a-fd5e-40fa-afd3-39cd795826a4":{"GrainOAuth2":{"type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://auth.grainledger.com/auth/v1/oauth/authorize","tokenUrl":"https://auth.grainledger.com/auth/v1/oauth/token","scopes":{"openid":"OpenID Connect","email":"Email address","profile":"Profile information"}}},"scopes":[],"schemeName":"GrainOAuth2"}},"5d65a984-a73a-4263-a6ec-edd6bb054d60":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"OAuth access token (JWT)","scopes":[],"schemeName":"BearerAuth"}}},"servers":{"f6713c7b-79dc-4516-9fa4-b80a2e5b565a":{"url":"https://api.grainledger.com","description":"API Server"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"grain_live_… or grain_test_…","description":"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.","scopes":[],"schemeName":"ApiKeyAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"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.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"ApiKeyAuth","name":"Authorization"}],"title":"ApiKeyAuth"},{"schemes":[{"scheme":{"type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://auth.grainledger.com/auth/v1/oauth/authorize","tokenUrl":"https://auth.grainledger.com/auth/v1/oauth/token","scopes":{"openid":"OpenID Connect","email":"Email address","profile":"Profile information"}}},"scopes":[],"schemeName":"GrainOAuth2"},"schema":{"title":"OAuth2 Auth","type":"string","isRequired":true,"description":"The access token received from the authorization server in the OAuth 2.0 flow.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"GrainOAuth2","name":"Authorization"}],"title":"GrainOAuth2"},{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"OAuth access token (JWT)","scopes":[],"schemeName":"BearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"OAuth access token (JWT)","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"}]},"originalFileLocation":"openapi.json"},"subdomain":"grainledger","siteName":"Grain API","title":"Create transaction - Grain API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-10T15:49:05.508Z","originalFileLocation":"api-reference/transactions/create-transaction.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Creates an uncategorized transaction. Grain queues rule and AI categorization after creation. Use Idempotency-Key for duplicate-safe retries: the same key and body return the existing transaction (201); a different body or a deleted original returns 409. To code the transaction yourself, follow with PUT /transactions/{id}/coding.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Grain API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/grainledger/PJpRtk0ZdVq1mTks/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/grainledger/PJpRtk0ZdVq1mTks/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/grainledger/PJpRtk0ZdVq1mTks/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/grainledger/PJpRtk0ZdVq1mTks/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/grainledger/PJpRtk0ZdVq1mTks/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/grainledger/PJpRtk0ZdVq1mTks/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/grainledger/PJpRtk0ZdVq1mTks/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/grainledger/PJpRtk0ZdVq1mTks/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/grainledger/PJpRtk0ZdVq1mTks/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create transaction - Grain API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Creates an uncategorized transaction. Grain queues rule and AI categorization after creation. Use Idempotency-Key for duplicate-safe retries: the same key and body return the existing transaction (201); a different body or a deleted original returns 409. To code the transaction yourself, follow with PUT /transactions/{id}/coding.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Grain API Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.grainledger.com/api-reference/transactions/create-transaction\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://grainledger.com/og-image.jpg?v=wheat-field-20260908\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create transaction - Grain API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Creates an uncategorized transaction. Grain queues rule and AI categorization after creation. Use Idempotency-Key for duplicate-safe retries: the same key and body return the existing transaction (201); a different body or a deleted original returns 409. To code the transaction yourself, follow with PUT /transactions/{id}/coding.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://grainledger.com/og-image.jpg?v=wheat-field-20260908\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/grainledger/PJpRtk0ZdVq1mTks/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Grain API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#03440c\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.grainledger.com/api-reference/transactions/create-transaction\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/transactions/create-transaction.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.grainledger.com/#organization\",\"name\":\"Grain API\",\"url\":\"https://docs.grainledger.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/grainledger/Jxl-ZANCEY95i3PU/images/grain-wordmark-on-light.svg?fit=max\u0026auto=format\u0026n=Jxl-ZANCEY95i3PU\u0026q=85\u0026s=47f8188964661273a33f4901a311ba81\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.grainledger.com#website\",\"name\":\"Grain API\",\"url\":\"https://docs.grainledger.com\",\"publisher\":{\"@id\":\"https://docs.grainledger.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.grainledger.com/api-reference/transactions/create-transaction#webpage\",\"url\":\"https://docs.grainledger.com/api-reference/transactions/create-transaction\",\"name\":\"Create transaction\",\"description\":\"Creates an uncategorized transaction. Grain queues rule and AI categorization after creation. Use Idempotency-Key for duplicate-safe retries: the same key and body return the existing transaction (201); a different body or a deleted original returns 409. To code the transaction yourself, follow with PUT /transactions/{id}/coding.\",\"dateModified\":\"2026-10-10T15:49:05.508Z\",\"isPartOf\":{\"@id\":\"https://docs.grainledger.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.grainledger.com/api-reference/transactions/create-transaction#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.grainledger.com/api-reference/transactions/create-transaction#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Transactions\",\"item\":\"https://docs.grainledger.com/api-reference/transactions/list-transactions\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create transaction\",\"item\":\"https://docs.grainledger.com/api-reference/transactions/create-transaction\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.grainledger.com/api-reference/transactions/create-transaction#apireference\",\"headline\":\"Create transaction\",\"name\":\"Create transaction\",\"description\":\"Creates an uncategorized transaction. Grain queues rule and AI categorization after creation. Use Idempotency-Key for duplicate-safe retries: the same key and body return the existing transaction (201); a different body or a deleted original returns 409. To code the transaction yourself, follow with PUT /transactions/{id}/coding.\",\"url\":\"https://docs.grainledger.com/api-reference/transactions/create-transaction\",\"mainEntityOfPage\":{\"@id\":\"https://docs.grainledger.com/api-reference/transactions/create-transaction#webpage\"},\"image\":\"https://grainledger.com/og-image.jpg?v=wheat-field-20260908\",\"dateModified\":\"2026-10-10T15:49:05.508Z\",\"publisher\":{\"@id\":\"https://docs.grainledger.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.grainledger.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Grain API\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Grain API\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/transactions/create-transaction.md","siteName":"Grain API","nav":{"global":{"anchors":[{"anchor":"Open app","icon":"https://mintlify.s3.us-west-1.amazonaws.com/grainledger/images/grain-logomark.svg","href":"https://app.grainledger.com"},{"anchor":"Support","icon":"circle-question","href":"https://grainledger.com/support"}]},"tabs":[{"tab":"Getting Started","icon":"rocket","pages":[{"title":"Getting Started","href":"/intro"}]},{"tab":"API Reference","icon":"code","groups":[{"group":"Funds","pages":[{"title":"List funds","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/funds","href":"/api-reference/funds/list-funds"}]},{"group":"Coding Reference Data","pages":[{"title":"List accounts","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/accounts","href":"/api-reference/coding-reference-data/list-accounts"},{"title":"List dimensions","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/dimensions","href":"/api-reference/coding-reference-data/list-dimensions"},{"title":"List vendors","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/vendors","href":"/api-reference/coding-reference-data/list-vendors"}]},{"group":"Organizations","pages":[{"title":"List authorized organizations","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/organizations","href":"/api-reference/organizations/list-authorized-organizations"}]},{"group":"Transactions","pages":[{"title":"List transactions","description":"Returns bank, card, and manual transactions with their coding. Comma-separated ID filters match any listed ID.","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/transactions","href":"/api-reference/transactions/list-transactions"},{"title":"Create transaction","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/transactions","href":"/api-reference/transactions/create-transaction"},{"title":"Get transaction by ID","description":null,"deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/transactions/{id}","href":"/api-reference/transactions/get-transaction-by-id"},{"title":"Delete transaction","deprecated":null,"version":null,"openapi":"/openapi.json delete /api/v1/transactions/{id}","href":"/api-reference/transactions/delete-transaction"},{"title":"Update transaction","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/v1/transactions/{id}","href":"/api-reference/transactions/update-transaction"},{"title":"Code or split a transaction","deprecated":null,"version":null,"openapi":"/openapi.json put /api/v1/transactions/{id}/coding","href":"/api-reference/transactions/code-or-split-a-transaction"},{"title":"Uncategorize a transaction","deprecated":null,"version":null,"openapi":"/openapi.json delete /api/v1/transactions/{id}/coding","href":"/api-reference/transactions/uncategorize-a-transaction"},{"title":"Set transaction dimensions","deprecated":null,"version":null,"openapi":"/openapi.json put /api/v1/transactions/{id}/dimensions","href":"/api-reference/transactions/set-transaction-dimensions"},{"title":"Approve a transaction","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/transactions/{id}/approve","href":"/api-reference/transactions/approve-a-transaction"},{"title":"Unapprove a transaction","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/transactions/{id}/unapprove","href":"/api-reference/transactions/unapprove-a-transaction"},{"title":"List transaction attachments","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/transactions/{id}/attachments","href":"/api-reference/transactions/list-transaction-attachments"},{"title":"Upload a receipt","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/transactions/{id}/attachments","href":"/api-reference/transactions/upload-a-receipt"},{"title":"Get an attachment download URL","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/transactions/{id}/attachments/{fileId}/download","href":"/api-reference/transactions/get-an-attachment-download-url"},{"title":"Delete an attachment","deprecated":null,"version":null,"openapi":"/openapi.json delete /api/v1/transactions/{id}/attachments/{fileId}","href":"/api-reference/transactions/delete-an-attachment"}]},{"group":"Bills","pages":[{"title":"List bills","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/bills","href":"/api-reference/bills/list-bills"},{"title":"Create bill","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/bills","href":"/api-reference/bills/create-bill"},{"title":"Get bill","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/bills/{id}","href":"/api-reference/bills/get-bill"},{"title":"Delete bill","deprecated":null,"version":null,"openapi":"/openapi.json delete /api/v1/bills/{id}","href":"/api-reference/bills/delete-bill"},{"title":"Update bill","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/v1/bills/{id}","href":"/api-reference/bills/update-bill"}]},{"group":"Donors","pages":[{"title":"List donors","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/donors","href":"/api-reference/donors/list-donors"},{"title":"Create donor","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/donors","href":"/api-reference/donors/create-donor"},{"title":"Get donor","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/donors/{id}","href":"/api-reference/donors/get-donor"},{"title":"Delete donor","deprecated":null,"version":null,"openapi":"/openapi.json delete /api/v1/donors/{id}","href":"/api-reference/donors/delete-donor"},{"title":"Update donor","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/v1/donors/{id}","href":"/api-reference/donors/update-donor"}]},{"group":"Contributions","pages":[{"title":"List contributions","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/contributions","href":"/api-reference/contributions/list-contributions"},{"title":"Create contribution","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/contributions","href":"/api-reference/contributions/create-contribution"},{"title":"Get contribution","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/contributions/{id}","href":"/api-reference/contributions/get-contribution"},{"title":"Delete contribution","deprecated":null,"version":null,"openapi":"/openapi.json delete /api/v1/contributions/{id}","href":"/api-reference/contributions/delete-contribution"},{"title":"Update contribution","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/v1/contributions/{id}","href":"/api-reference/contributions/update-contribution"}]},{"group":"Settlements","pages":[{"title":"List settlements","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/settlements","href":"/api-reference/settlements/list-settlements"},{"title":"Create settlement","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/settlements","href":"/api-reference/settlements/create-settlement"},{"title":"Get settlement","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/settlements/{id}","href":"/api-reference/settlements/get-settlement"},{"title":"Delete settlement","deprecated":null,"version":null,"openapi":"/openapi.json delete /api/v1/settlements/{id}","href":"/api-reference/settlements/delete-settlement"},{"title":"Update settlement","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/v1/settlements/{id}","href":"/api-reference/settlements/update-settlement"}]},{"group":"Giving Batches","pages":[{"title":"List giving batches","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/batches","href":"/api-reference/giving-batches/list-giving-batches"},{"title":"Create giving batch","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/batches","href":"/api-reference/giving-batches/create-giving-batch"},{"title":"Get giving batch","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/batches/{id}","href":"/api-reference/giving-batches/get-giving-batch"},{"title":"Delete giving batch","deprecated":null,"version":null,"openapi":"/openapi.json delete /api/v1/batches/{id}","href":"/api-reference/giving-batches/delete-giving-batch"},{"title":"Update giving batch","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/v1/batches/{id}","href":"/api-reference/giving-batches/update-giving-batch"}]},{"group":"Pledge Card Imports","pages":[{"title":"Import pledge card data for review","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/pledge-card-imports","href":"/api-reference/pledge-card-imports/import-pledge-card-data-for-review"},{"title":"List pledge card import reference data","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/pledge-card-imports/reference-data","href":"/api-reference/pledge-card-imports/list-pledge-card-import-reference-data"}]},{"group":"Pledges","pages":[{"title":"List pledges","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/pledges","href":"/api-reference/pledges/list-pledges"},{"title":"Create pledge","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/pledges","href":"/api-reference/pledges/create-pledge"},{"title":"Get pledge","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/pledges/{id}","href":"/api-reference/pledges/get-pledge"},{"title":"Delete pledge","deprecated":null,"version":null,"openapi":"/openapi.json delete /api/v1/pledges/{id}","href":"/api-reference/pledges/delete-pledge"},{"title":"Update pledge","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/v1/pledges/{id}","href":"/api-reference/pledges/update-pledge"}]},{"group":"Households","pages":[{"title":"List households","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/households","href":"/api-reference/households/list-households"},{"title":"Create household","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/households","href":"/api-reference/households/create-household"},{"title":"Get household","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/households/{id}","href":"/api-reference/households/get-household"},{"title":"Delete household","deprecated":null,"version":null,"openapi":"/openapi.json delete /api/v1/households/{id}","href":"/api-reference/households/delete-household"},{"title":"Update household","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/v1/households/{id}","href":"/api-reference/households/update-household"},{"title":"Add household member","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/households/{id}/members","href":"/api-reference/households/add-household-member"},{"title":"Remove household member","deprecated":null,"version":null,"openapi":"/openapi.json delete /api/v1/households/{id}/members/{donorId}","href":"/api-reference/households/remove-household-member"},{"title":"Update household member","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/v1/households/{id}/members/{donorId}","href":"/api-reference/households/update-household-member"}]}]}]},"basePath":"","title":"Create transaction - Grain API","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CiUHMMOm.js","snippetPresets-BgfXU7Bw.js","utils-DWvOwgy_.js","style-to-object-BY3JEAdk.js","utils-BN7RXSMJ.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-CFw8bq89.js","conditional-requirements-CFM0id0Q.js","cloneDeep-CAwdfOU2.js","_Uint8Array-BJr8e-ZL.js","isObject-FP1Yky1u.js","ApiExamples-XX0UgMZK.js","usePlaygroundInputsStore-DXDFSa1V.js","shallow-CdX5aREi.js","isEqual-CoOaxexF.js","CodeSnippets-Cg2wpzWm.js","CodeSnippet-D_HwgQO_.js","getApiPlaygroundDisplay-CmCoerhe.js","Page-CVJ-f_k1.js","DynamicMarkdown-CQM9Bhbv.js","SectionHeading-DpbrP8nQ.js","icon-BPCgijHy.js","MethodPill-GQ8DuY0c.js","getPastedJson-Cb5mT31m.js","Check2Icon-a7bUI6e8.js","axios-CsQoIw0U.js","Markdown-CX2QY19L.js","AssistantPageLink-CY3bFglh.js","dist-Dl6_zDnT.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}