---
title: "Order a Credit Report"
method: POST
path: "/v1/users/{userId}/creditReports/order"
tags: ["Debt Profile"]
---

# Order a Credit Report

`POST /v1/users/{userId}/creditReports/order`

## Request

- Base URL: `https://sandbox-api.spinwheel.io`
- URL: `https://sandbox-api.spinwheel.io/v1/users/{userId}/creditReports/order`
- Auth: API key in header `Authorization`

Order a credit report to connect liabilities, credit score and more

## Path parameters

- `userId` string, required

## Response `200`

Successful response

- OrderReportResponse
  - `status` ResponseStatus, required
    - `code` number
    - `desc` string
    - `messages` Message[]
      - `desc` string, required
      - `type` 'ERROR' | 'WARN' | 'INFO'
  - `data` OrderReportResponseData, required
    - `transactionStatus` 'IN_PROGRESS' | 'FAILED' | 'COMPLETED', required: Status of the transaction
    - `transactionId` string, required: Transaction ID

## Other responses

- `400`: Bad Request
- `401`: Unauthorized response
- `404`: Not found response
- `500`: Internal server error response

## Changes

- **2026-11-03** `aa032469622f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/spinwheel/apis/discover/changes/v1/users/:userId/creditReports/order/post.md)

---

[API](https://skmtc.dev/spinwheel/apis/discover.md) - [All operations](https://skmtc.dev/spinwheel/apis/discover/llms.txt) - [OpenAPI document](https://skmtc.dev/spinwheel/apis/discover/revisions/aa032469622f?raw)
