# JustiFi Reports API

**Canonical:** https://apis.io/apis/justifi/justifi-reports-api/  
**Provider:** JustiFi — https://apis.io/providers/justifi/  
**Base URL:** https://api.justifi.ai/v1  
**Documentation:** https://docs.justifi.tech/api-spec

JustiFi Reports API is one of 27 APIs that [JustiFi](https://apis.io/providers/justifi/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Reports. The published artifact set on APIs.io includes an OpenAPI specification and authentication docs.

Reports can be used to pull data for various different resources. They are CSV format, and can be filtered by date and sub account. Once a the create endpoint is called via POST, a report will be in `created` status. The report will move to `processing` status once it is being generated. Finally, when the report is generated, and the CSV file is available, the report will be in `completed` status. To download a report, you can use the `download_url` provided in the response when retrieving a report. We use presigned URLs to allow you to download the report directly from our S3 bucket. ## Report Types ### Payout Report Contains balance transaction data for payouts. | Column | Description | | ------ | ----------- | | id | Balance transaction ID | | type | Transaction type | | currency | Currency | | amount | Amount in cents | | fee | Fee amount in cents | | net | Net amount in cents | | source_id | Source object ID | | source_account_id | Source account ID | | source_type | Source object type | | source_amount | Source amount in cents | | available_on | When funds become available | | payment_id | Associated payment ID | | created_at | Creation timestamp | | payment_method_name | Payment method name | | source_payment_id | Payment ID associated with the source | | payout_id | Associated payout ID | | payout_created_at | Payout creation timestamp | | payout_deposits_at | Expected payout deposit date | ### Proceeds Report Contains platform proceeds data. | Column | Description | | ------ | ----------- | | id | Balance transaction ID | | type | Transaction type | | currency | Currency code | | amount | Amount in cents | | fee | Fee amount in cents | | net | Net amount in cents | | source_id | Source object ID | | source_account_id | Source account ID | | source_type | Source object type | | source_amount | Source amount in cents | | application_fee_amount | Application fee in cents | | platform_fee_amount | Platform fee in cents | | proceeds | Calculated proceeds in cents | | available_on | When funds become available | | created_at | Creation timestamp | | fee_major_category | Fee major category | | fee_minor_category | Fee minor category | | fee_description | Fee description | | fee_product_code | Fee product code | | fee_batch_date | Fee batch date | | payment_method_type | Payment method type | | payment_method_brand | Payment method brand | | source_payment_id | Payment ID associated with the source | | payout_id | Associated payout ID | | payout_created_at | Payout creation timestamp | | payout_deposits_at | Expected payout deposit date |

## Machine-readable artifacts (6)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/justifi/refs/heads/main/openapi/justifi-reports-api-openapi.yml
- **Webhooks** — https://raw.githubusercontent.com/api-evangelist/justifi/refs/heads/main/asyncapi/justifi-webhooks.yml
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/justifi/refs/heads/main/authentication/justifi-authentication.yml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/justifi/refs/heads/main/errors/justifi-problem-types.yml
- **DeclineCodes** — https://raw.githubusercontent.com/api-evangelist/justifi/refs/heads/main/errors/justifi-decline-codes.yml
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/justifi/refs/heads/main/data-model/justifi-data-model.yml

## Other JustiFi APIs (12)

- [JustiFi Ach Return Fees API](https://apis.io/apis/justifi/justifi-ach-return-fees-api/)
- [JustiFi Address API](https://apis.io/apis/justifi/justifi-address-api/)
- [JustiFi API Credentials API](https://apis.io/apis/justifi/justifi-api-credentials-api/)
- [JustiFi Balance Transactions API](https://apis.io/apis/justifi/justifi-balance-transactions-api/)
- [JustiFi Bank Account API](https://apis.io/apis/justifi/justifi-bank-account-api/)
- [JustiFi Bind Insurance API](https://apis.io/apis/justifi/justifi-bind-insurance-api/)
- [JustiFi Business API](https://apis.io/apis/justifi/justifi-business-api/)
- [JustiFi Checkouts API](https://apis.io/apis/justifi/justifi-checkouts-api/)
- [JustiFi Disputes API](https://apis.io/apis/justifi/justifi-disputes-api/)
- [JustiFi Document API](https://apis.io/apis/justifi/justifi-document-api/)
- [JustiFi Fee Configurations API](https://apis.io/apis/justifi/justifi-fee-configurations-api/)
- [JustiFi Identity API](https://apis.io/apis/justifi/justifi-identity-api/)

## Tags

Reports

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/justifi/justifi-reports-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/justifi/.
