---
title: "Get Dashboard Records"
method: POST
path: "/api/recon/v3/dashboard-records"
tags: ["Recon APIs"]
---

# Get Dashboard Records

`POST /api/recon/v3/dashboard-records`

## Request

- Base URL: `https://api.portone.cloud`
- URL: `https://api.portone.cloud/api/recon/v3/dashboard-records`
- Auth: none declared

This endpoint is used to fetch the ingested records of a Data Source

## Headers

- `X-Portone-Client-Key` string
- `Authorization` string
- `Content-Type` string

## Request body

- object
  - `from` string, required: The Start date of date range
  - `to` string, required: The End date of date range
  - `data_source` string, required: The data_source_id for which you want to fetch the records
  - `record_type` 'payment' | 'refund', required: payment for forward transactions and refund for recon of refund transactions
  - `status` 'reconciled' | 'unreconciled' | 'SankeyReconOrders' | 'SankeyUnmatchedSku', required: status of records, can be empty string
  - `mismatches` 'mismatch_no' | 'mismatch_fee' | 'mismatch_tax' | 'mismatch_amount' | 'mismatch_quantity': to fetch reconciled transactions on basis of mismatch like Amount mismatch, Fee mismatch, Quantity mismatch, etc.
  - `msm_id` integer, required: Merchant Source Mapping ID, get it from data-sources api
  - `brand_id` unknown[]: Array of brand_id, can be fetched from merchant-custom-data api
    - unknown
  - `marketplace_id` unknown[]: Array of marketplace_id, can be fetched from merchant-custom-data api
    - unknown
  - `country` unknown[]: Array of country, can be fetched from merchant-custom-data api
    - unknown
  - `currency` unknown[]: Array of currency, can be fetched from merchant-custom-data api
    - unknown
  - `page` integer, required: The page number of the records to be fetched
  - `page_size` integer, required: The page size of the records to be fetched
  - `environment` 'live' | 'sandbox', required: The environment of the transaction is either live OR sandbox

## Response `200`

OK

- object
  - `data` object
    - `content` object[]: List of payment records with reconciliation status.
      - `amount` number: The total amount of the transaction.
      - `amount_mismatch` number: The mismatch amount, if any.
      - `created_at` string, date-time: When the record was created.
      - `currency` string: Currency code (if applicable).
      - `deleted_at` string, date-time, nullable: Timestamp of when the record was deleted (if applicable).
      - `fee_mismatch` number: Fee mismatch amount, if any.
      - `marketplace_id` string: The ID of the marketplace (e.g., LAZADA).
      - `metadata` object, nullable: Additional metadata (if applicable).
      - `metadata_b` object, nullable: Secondary metadata (if applicable).
      - `quantity` integer: The quantity of items in the transaction.
      - `quantity_mismatch` number: Quantity mismatch, if any.
      - `raw_status` string: The raw status of the record (e.g., confirmed).
      - `record_created_at` string, date-time: When the record was originally created.
      - `record_ref` string: Reference number for the transaction.
      - `record_type` string: The type of record (e.g., payment).
      - `sku_id` string: The SKU identifier for the item in the transaction.
      - `source_display_name` string: The display name of the data source.
      - `source_name` string: The name of the data source (e.g., LAZADA_ORDER).
      - `status` string: Reconciliation status (e.g., reconciled).
      - `tags` string[]: Tags associated with the record.
      - `tax_mismatch` number: Tax mismatch amount, if any.
      - `transaction_id` string: Unique ID for the transaction.
      - `updated_at` string, date-time: When the record was last updated.
    - `numberOfElements` integer: Number of elements in the current page.
    - `page` integer: Current page number.
    - `size` integer: Number of records per page.
    - `totalElements` integer: Total number of elements across all pages.
    - `totalPages` integer: Total number of pages.
  - `message` string: The description of the API request execution result.
  - `status_code` string: Status code of the API response.
  - `status_reason` string: Status reason of the API response.

## Other responses

- `400`: Bad Request

---

[API](https://skmtc.dev/portone/apis/recon-apis.md) - [All operations](https://skmtc.dev/portone/apis/recon-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/portone/apis/recon-apis/revisions/fe87490291bb?raw)