> For the complete documentation index, see [llms.txt](https://developers.bloomcredit.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.bloomcredit.io/reference/krakend-api-gateway/statements/create-statements-in-batch.md).

# Create Statements In Batch

Creates up to 24 statements in a single request. Each statement is validated and persisted independently, so the call returns `201` even when some statements fail: successfully created statements are listed under `success` and rejected ones under `fail`, each with the errors that caused the rejection. Statements are correlated to the request by `statement_identifier` together with `account_id` and `statement_date`. Supplying more than 24 statements rejects the whole request with `422`.

```json
{"openapi":"3.1.0","info":{"title":"KrakenD - API Gateway","version":"2.0"},"tags":[{"name":"Statements"}],"servers":[{"description":"Furnishment sandbox server, for testing purposes (v2)","url":"https://sandbox.bloom.dev"},{"description":"Furnishment server","url":"https://api.bloomcredit.io"},{"description":"Production Consumer Permissioned Data server","url":"https://api.bloomplus.com"},{"description":"Development Consumer Permissioned Data server","url":"https://api.bloomplus.dev"}],"security":[{"Oauth2ClientCredentials":["furnishment:all"]}],"components":{"securitySchemes":{"Oauth2ClientCredentials":{"flows":{"clientCredentials":{"scopes":{"furnishment:all":"Manage accounts."},"tokenUrl":"https://authn.bloomcredit.dev/oauth2/token"}},"type":"oauth2"}},"schemas":{"Request_StatementCreateBatch_":{"description":"Request envelope for batch statement creation.","properties":{"data":{"allOf":[{"$ref":"#/components/schemas/RequestData_StatementCreateBatch_"}],"description":"Primary API resource payload."}},"required":["data"],"title":"Request[StatementCreateBatch]","type":"object"},"RequestData_StatementCreateBatch_":{"description":"Represents request data statement create batch.","properties":{"attributes":{"allOf":[{"$ref":"#/components/schemas/StatementCreateBatch"}],"description":"Domain attributes for this resource."},"id":{"title":"Id","type":"string","description":"Stable identifier for this resource."},"relationships":{"additionalProperties":{"allOf":[{"$ref":"#/components/schemas/RequestRelationshipModel"}],"description":"Relationships value associated with this resource."},"title":"Relationships","type":"object","description":"API relationships to associated resources."},"type":{"enum":["StatementCreateBatch"],"title":"Type","type":"string","description":"API resource type. Allowed values: `StatementCreateBatch`."}},"required":["type","attributes"],"title":"RequestData[StatementCreateBatch]","type":"object"},"StatementCreateBatch":{"description":"A batch of statements to create in a single request. At most 24 statements may be submitted per request.","properties":{"statements":{"items":{"$ref":"#/components/schemas/StatementCreate"},"maxItems":24,"title":"Statements","type":"array","description":"Statements to create. Each entry is validated independently, so a batch may partially succeed."}},"required":["statements"],"title":"StatementCreateBatch","type":"object"},"StatementCreate":{"properties":{"account_id":{"format":"uuid","title":"Account Id","type":"string","description":"Unique identifier of the furnished account."},"actual_monthly_payment":{"minimum":0,"title":"Actual Monthly Payment","type":"number","description":"Payment received during the statement period. Must be a non-negative monetary amount."},"amount_past_due":{"minimum":0,"title":"Amount Past Due","type":"number","description":"Total amount past due as of the statement date. Must be a non-negative monetary amount."},"credit_limit":{"minimum":0,"title":"Credit Limit","type":"number","description":"Credit limit as of the statement date. Must be non-negative and supports at most 15 digits with two decimal places."},"current_balance":{"minimum":0,"title":"Current Balance","type":"number","description":"Outstanding balance as of the statement date. Must be non-negative and supports at most 15 digits with two decimal places."},"days_delinquent":{"default":0,"title":"Days Delinquent","type":"integer","description":"Number of days past due as of the statement date. Defaults to zero; explicit `null` is rejected."},"highest_balance":{"default":0,"minimum":0,"title":"Highest Balance","type":"number","description":"Highest account balance reported for the period. Defaults to zero; explicit `null` is rejected."},"last_payment_date":{"format":"date","title":"Last Payment Date","type":"string","description":"Date of the most recent consumer payment known for this statement."},"scheduled_monthly_payment":{"minimum":0,"title":"Scheduled Monthly Payment","type":"number","description":"Contractual payment due for the statement period. Must be a non-negative monetary amount."},"statement_date":{"format":"date","title":"Statement Date","type":"string","description":"Reporting date represented by this statement."},"statement_identifier":{"title":"Statement Identifier","type":"string","description":"Partner-supplied identifier used to deduplicate and correlate the statement; stored tokenized by the service."}},"required":["account_id","statement_date","current_balance","credit_limit","scheduled_monthly_payment","actual_monthly_payment","amount_past_due","statement_identifier"],"title":"StatementCreate","type":"object","description":"Attributes accepted when creating a statement."},"RequestRelationshipModel":{"properties":{"data":{"anyOf":[{"$ref":"#/components/schemas/ResourceIdentifier"},{"items":{"allOf":[{"$ref":"#/components/schemas/ResourceIdentifier"}],"description":"Primary API resource payload."},"type":"array","description":"Primary API resource payload."}],"title":"Data","description":"Primary API resource payload."}},"title":"RequestRelationshipModel","type":"object","description":"Represents request relationship model."},"ResourceIdentifier":{"description":"https://jsonapi.org/format/#document-resource-identifier-objects","properties":{"id":{"title":"Id","type":"string","description":"Stable identifier for this resource."},"meta":{"title":"Meta","type":"object","description":"Metadata associated with the response."},"type":{"title":"Type","type":"string","description":"API resource type."}},"required":["id","type"],"title":"ResourceIdentifier","type":"object"},"Response_StatementBatch_":{"description":"Response envelope for batch statement creation.","properties":{"data":{"allOf":[{"$ref":"#/components/schemas/ResponseData_StatementBatch_"}],"description":"Primary API resource payload."},"included":{"items":{"description":"Included associated with this resource."},"title":"Included","type":"array","description":"Collection of included."},"links":{"additionalProperties":{"anyOf":[{"type":"string","description":"Links value associated with this resource."},{"$ref":"#/components/schemas/LinkHref"}],"description":"Links value associated with this resource."},"title":"Links","type":"object","description":"Links related to this resource or collection."},"meta":{"title":"Meta","type":"object","description":"Metadata associated with the response."}},"required":["data"],"title":"Response[StatementBatch]","type":"object"},"ResponseData_StatementBatch_":{"description":"Represents response data statement batch.","properties":{"attributes":{"allOf":[{"$ref":"#/components/schemas/BatchStatement"}],"default":{},"title":"Attributes","description":"Domain attributes for this resource."},"id":{"title":"Id","type":"string","description":"Stable identifier for this resource."},"links":{"additionalProperties":{"anyOf":[{"type":"string","description":"Links value associated with this resource."},{"$ref":"#/components/schemas/LinkHref"}],"description":"Links value associated with this resource."},"title":"Links","type":"object","description":"Links related to this resource or collection."},"relationships":{"additionalProperties":{"allOf":[{"$ref":"#/components/schemas/ResponseRelationshipModel"}],"description":"Relationships value associated with this resource."},"title":"Relationships","type":"object","description":"API relationships to associated resources."},"type":{"enum":["StatementBatch"],"title":"Type","type":"string","description":"API resource type. Allowed values: `StatementBatch`."}},"required":["id","type"],"title":"ResponseData[StatementBatch]","type":"object"},"BatchStatement":{"description":"Per-statement outcome of a batch statement creation request.","properties":{"fail":{"items":{"$ref":"#/components/schemas/BatchStatementFail"},"title":"Fail","type":"array","description":"Statements that were rejected, each with the errors that caused the rejection."},"id":{"title":"Id","type":"string","description":"Placeholder API identifier for the batch result; always `0`."},"success":{"items":{"$ref":"#/components/schemas/BatchStatementSucess"},"title":"Success","type":"array","description":"Statements that were created successfully."}},"required":["success","fail","id"],"title":"BatchStatement","type":"object"},"BatchStatementFail":{"description":"A single statement from the batch that could not be created.","properties":{"account_id":{"format":"uuid","title":"Account Id","type":"string","description":"Account the rejected statement was intended for."},"errors":{"items":{"$ref":"#/components/schemas/JSONAPIError"},"title":"Errors","type":"array","description":"Errors that prevented this statement from being created."},"statement_date":{"format":"date","title":"Statement Date","type":"string","description":"Statement date of the rejected statement, echoed from the request."},"statement_identifier":{"title":"Statement Identifier","type":"string","description":"Partner-supplied identifier of the rejected statement, echoed from the request."}},"required":["account_id","statement_date","errors","statement_identifier"],"title":"BatchStatementFail","type":"object"},"JSONAPIError":{"properties":{"detail":{"default":"","title":"Detail","type":"string","description":"Human-readable detail explaining the result or error."},"status":{"title":"Status","type":"integer","description":"Bloom internal error code, computed as `error group * 100 + error number`. This is not the HTTP status code."},"title":{"title":"Title","type":"string","description":"Short, human-readable summary of the error."}},"required":["title"],"title":"JSONAPIError","type":"object","description":"Error representation used when a request cannot be completed (jsonapierror)."},"BatchStatementSucess":{"description":"A single statement from the batch that was created successfully.","properties":{"account_id":{"format":"uuid","title":"Account Id","type":"string","description":"Account the statement was created against."},"statement_date":{"format":"date","title":"Statement Date","type":"string","description":"Statement date of the created statement."},"statement_id":{"format":"uuid","title":"Statement Id","type":"string","description":"Identifier assigned to the newly created statement."},"statement_identifier":{"title":"Statement Identifier","type":"string","description":"Partner-supplied identifier of the created statement, echoed from the request."}},"required":["account_id","statement_date","statement_id","statement_identifier"],"title":"BatchStatementSucess","type":"object"},"LinkHref":{"properties":{"href":{"title":"Href","type":"string","description":"Href associated with this resource."},"meta":{"title":"Meta","type":"object","description":"Metadata associated with the response."}},"required":["href","meta"],"title":"LinkHref","type":"object","description":"Represents link href."},"ResponseRelationshipModel":{"properties":{"data":{"anyOf":[{"$ref":"#/components/schemas/ResourceIdentifier"},{"items":{"allOf":[{"$ref":"#/components/schemas/ResourceIdentifier"}],"description":"Primary API resource payload."},"type":"array","description":"Primary API resource payload."}],"title":"Data","description":"Primary API resource payload."},"links":{"additionalProperties":{"anyOf":[{"type":"string","description":"Links value associated with this resource."},{"$ref":"#/components/schemas/LinkHref"}],"description":"Links value associated with this resource."},"title":"Links","type":"object","description":"Links related to this resource or collection."},"meta":{"title":"Meta","type":"object","description":"Metadata associated with the response."}},"title":"ResponseRelationshipModel","type":"object","description":"Represents response relationship model."},"JSONAPIErrorResponse":{"properties":{"errors":{"items":{"allOf":[{"$ref":"#/components/schemas/JSONAPIError"}],"description":"Error associated with this resource."},"title":"Errors","type":"array","description":"Errors that prevented the request from completing."}},"required":["errors"],"title":"JSONAPIErrorResponse","type":"object","description":"Error representation used when a request cannot be completed (jsonapierror response)."}}},"paths":{"/v2/furnishment/statements/batch":{"post":{"operationId":"create_statements_batch_api_v1_statements_batch_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Request_StatementCreateBatch_"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Response_StatementBatch_"}}},"description":"Batch processed. Individual statements may have failed; inspect `success` and `fail`."},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JSONAPIErrorResponse"}}},"description":"The batch exceeded the maximum size, or the request body failed schema validation."}},"summary":"Create Statements In Batch","tags":["Statements"],"description":"Creates up to 24 statements in a single request. Each statement is validated and persisted independently, so the call returns `201` even when some statements fail: successfully created statements are listed under `success` and rejected ones under `fail`, each with the errors that caused the rejection. Statements are correlated to the request by `statement_identifier` together with `account_id` and `statement_date`. Supplying more than 24 statements rejects the whole request with `422`."}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://developers.bloomcredit.io/reference/krakend-api-gateway/statements/create-statements-in-batch.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.