creditReport
Query
Get a previously pulled credit report
Query Signature
query { creditReport(input: GetCreditReportInput!): GetCreditReportResponse!}Example Request
query CreditReport($input: GetCreditReportInput!) { creditReport(input: $input) { # Add fields you want to retrieve }}Example Variables:
{ "input": { "creditReportId": "cr-abc123def456" }}Open in Apollo Studio Explorer →
Click the link above to open this query in Apollo Studio Explorer with the query pre-filled. You’ll need to authenticate with your sandbox credentials.
Example Response
{ "data": { "creditReport": { "data": { "id": "cr-abc123def456", "reqOrgId": "org-alleviate", "reqOrgContactId": "contact-12345", "leadId": "lead-67890", "applicantResidenceState": "CA", "applicantFirstName": "John", "applicantLastName": "Doe", "source": "CRS_EQUIFAX", "reportStatus": "COMPLETED", "fileStatus": "COMPLETED", "createdAt": "2025-01-15T10:30:00.000Z", "scores": [ { "scoreType": "VantageScore4", "score": 680 } ], "debts": [ { "id": "debt-001", "creditorName": "Capital One", "accountNumber": "****1234", "currentBalance": 5432.1, "originalBalance": 6000, "accountType": "CREDIT_CARD", "portfolioType": "REVOLVING", "ecoaCode": "I", "isCollection": false, "openDate": "2020-06-15", "lastPaymentDate": "2025-01-01" } ], "publicRecords": [] }, "errors": null } }}Arguments
| Argument | Type | Description |
|---|---|---|
input | GetCreditReportInput! | Input containing the credit report ID to retrieve |
Input Types
GetCreditReportInput
Input for Getting Credit Report by creditReportId
Required Fields:
| Field | Type | Description |
|---|---|---|
creditReportId | String! | Credit report ID |
Response Type
Returns: GetCreditReportResponse!
GetCreditReportResponse
Get Credit Report Response
| Field | Type | Description |
|---|---|---|
data | CreditReportNode | Single CreditReport |
errors | [GetCreditReportResponseError] | List of error messages |
CreditReportNode
Credit Report Node
| Field | Type | Description |
|---|---|---|
id | ID! | Credit report ID |
reqOrgId | String | Requesting organization ID |
reqOrgContactId | String | Requesting organization contact ID |
leadId | String | Sigma lead ID |
applicantResidenceState | String | State where customer resides |
publicRecords | [PublicRecord] | Public records |
creditReportUserId | String | Credit report user ID |
debts | [CreditReportDebt] | Debts as JSON data |
source | String | Source of the credit report, e.g., Spinwheel, CRS Equifax, or CRS TransUnion |
fileMetadata | FileMetadata | File metadata. |
reportStatus | String | Current status of the credit report: PENDING, IN_PROGRESS, COMPLETED, FAILED |
fileStatus | String | IN_PROGRESS, COMPLETED |
createdAt | Date | Date the credit report was created |
applicantFirstName | String | Applicant’s first name |
applicantMiddleName | String | Applicant’s middle name |
applicantLastName | String | Applicant’s last name |
applicantSsn | String | Applicant’s ssn name |
applicantDob | String | Applicant’s dob |
applicantAlternativeNames | [AlternativeName] | Applicant’s alternative names |
scores | [Score] | Credit scores from various credit evaluation models |
reportRequestedAt | Date | Date the credit report was requested |
PublicRecord
Public Record
| Field | Type | Description |
|---|---|---|
bankruptcyCode | String! | Bankruptcy code |
bankruptcyDateFiled | String | Bankruptcy date filed |
bankruptcyDispositionType | String | Bankruptcy disposition type |
CreditReportDebt
Credit Report Debt
| Field | Type | Description |
|---|---|---|
id | ID! | Debt ID |
creditorId | String | creditor ID |
externalDebtId | String | This is replaced by accountNumber @deprecated Use accountNumber instead |
accountNumber | String | Original credit report account number |
applicantState | String | Applicants state of residence. |
ecoaCode | String | ECOA code |
creditorName | String | Creditor name from credit report |
parentCreditorName | String | Parent creditor name |
parentCreditorId | String | Parent creditor ID |
originalCreditorName | String | Original creditor name from credit report |
creditorType | String | Creditor type |
accountType | String | Account type |
portfolioType | String | Portfolio type |
debtType | String | Debt type |
currentBalance | Float | Current debt balance |
openDate | String | Date the debt was opened |
lastPaymentDate | String | Date of last payment |
hasLastPayment | Boolean | True if the most recent payment has been made as of the date this credit report was pulled |
narrativeCodes | [String] | Narrative codes that might include bankruptcy codes |
bankruptcyDateFiled | String | Bankruptcy date filed |
applicantId | String | Applicant Id |
coApplicantId | String | CoApplicant Id |
originalBalance | Float | Original debt balance |
isCollection | Boolean | Flag to show if the debt is in collection |
delinquency | String | account rating /delinquency value |
monthlyPayment | Float | Monthly payment |
forthDebtTypeId | String | Forth Debt Type ID |
remarks | [String] | Remarks |
FileMetadata
File metadata
| Field | Type | Description |
|---|---|---|
reqOrgContactId | String | Requesting organization contact ID |
creditReportUserId | String | Credit report user ID |
source | String | Credit Report Vendor source e.g. SPINWHEEL, CRS Equifax, or CRS TransUnion |
uploadDate | String | ISO 8601 format date string |
fileName | String | Document name |
contentType | String | File type |
fileSize | String | Size in bytes |
type | String | Document type |
AlternativeName
Alternative name associated with the applicant
| Field | Type | Description |
|---|---|---|
firstName | String | Alternative first name |
lastName | String | Alternative last name |
unparsedName | String | Full alternative name (unparsed) |
Score
Credit score information from credit evaluation models
| Field | Type | Description |
|---|---|---|
modelName | String | The name of a risk model as provided by the repository bureaus. |
sourceType | String | This element describes the source of the credit file, Equifax, Experian, Trans Union or Unspecified if the specific sources are not specified. |
scoreValue | String | Numeric credit score resulting from credit evaluation model. |
scoreFactors | [ScoreFactor] | Factors of the borrower’s credit which give context to the referenced credit score. |
ScoreFactor
Score Factor associated with a credit score
| Field | Type | Description |
|---|---|---|
scoreFactorCode | String | Factors of the borrower’s credit which give context to the referenced credit score. The factor is normally a numeric code. |
scoreFactorText | String | The text remarks associated with a Score Factor. |
GetCreditReportResponseError
Get Credit Report Response Error
| Field | Type | Description |
|---|---|---|
message | String | Error message |
Error Types
The response may include the following error types:
GetCreditReportResponseError
Get Credit Report Response Error
| Field | Type | Description |
|---|---|---|
message | String | Error message |
Common Errors
| Error Code | Description | Resolution |
|---|---|---|
VALIDATION_ERROR | Input validation failed | Check required fields and formats |
UNAUTHORIZED | Invalid or expired token | Re-authenticate and retry |
NOT_FOUND | Resource not found | Verify the ID or reference |