> For the complete documentation index, see [llms.txt](https://docs.xyb.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.xyb.co/xyb-ledger/api-reference-guides/transaction-management-apis/movement-management-apis.md).

# Posting Management APIs

### **1. Retrieve Account Postings**

**Use Case**: Fetches all postings related to a specific account, including committed and reserved balances.

* **Example**: A finance team retrieves all postings for a corporate account to verify recent transactions and reconcile discrepancies.

{% openapi src="/files/5af2rdQ5h4ZxHvDZfiyJ" path="/api/v1/{origin:group|chart}/{parent:\[^*]+}/{account:\[^*]+}/{wallet:\[^*]+}/{currency:\[^*]+}/{balance:\[^\*]+}/" method="get" %}
[openapi-ledger.json](https://content.gitbook.com/content/akJn6TxWIBAbZwLlYoVP/blobs/S917VQZQHm6OZGrj1mf5/openapi-ledger.json)
{% endopenapi %}

***

### **2. Query Postings**

* **Method**: `GET`
* **Endpoint**: `/integration/monese/postings`
* **Use Case**: Retrieves postings based on parameters such as account reference, wallet currency, or date range.
  * **Example**: An auditor queries all postings for a customer’s wallet over the past month to detect unusual spending patterns.

***

### **3. Query Payment Postings**

* **Method**: `GET`
* **Endpoint**: `/integration/monese/payment/postings`
* **Use Case**: Fetches postings linked to specific payment IDs for reconciliation and tracking.
  * **Example**: A financial institution verifies whether a bank transfer from a customer was successfully posted to their wallet.

***

#### **Example Use Cases**

* **Transaction Auditing**: Retrieve postings for an account to verify financial accuracy and detect errors.
* **Fraud Monitoring**: Query postings for large or unusual transactions to identify suspicious activity.
* **Real-Time Balance Updates**: Fetch postings to confirm the latest transactions and ensure account balances are current.
* **Financial Reconciliation**: Compare postings with movements to validate that all fund transfers have been properly recorded.


---

# 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://docs.xyb.co/xyb-ledger/api-reference-guides/transaction-management-apis/movement-management-apis.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.
