addLeadIdToCreditReport

Mutation

Associate a Sigma lead ID with an existing credit report

Mutation Signature

mutation {
  addLeadIdToCreditReport(input: AddLeadIdToCreditReportInput!): GetCreditReportResponse!
}

Example Request

GraphQL

mutation AddLeadIdToCreditReport($input: AddLeadIdToCreditReportInput!) {
  addLeadIdToCreditReport(input: $input) {
    # Add fields you want to retrieve
  }
}

Example Variables:

{
  "input": {
    "creditReportId": "cr-abc123def456",
    "leadId": "lead-new-12345"
  }
}

Apollo Studio

Open in Apollo Studio Explorer →

Click the link above to open this mutation in Apollo Studio Explorer with the query pre-filled. You’ll need to authenticate with your sandbox credentials.

Example Response

{
  "data": {
    "addLeadIdToCreditReport": {
      "data": {
        "id": "cr-abc123def456",
        "reqOrgContactId": "contact-12345",
        "leadId": "lead-new-12345",
        "applicantResidenceState": "CA",
        "source": "CRS_EQUIFAX",
        "reportStatus": "COMPLETED",
        "fileStatus": "COMPLETED"
      },
      "errors": null
    }
  }
}

Arguments

Argument	Type	Description
input	AddLeadIdToCreditReportInput!	Input containing the credit report ID and lead ID to associate

Input Types

AddLeadIdToCreditReportInput

Required Fields:

Field	Type	Description
creditReportId	String!	Internal credit report ID
leadId	String!	Sigma lead 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

Manual Error Documentation

Add service-specific error codes and their resolutions below.

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

Related

• Back to Credit Reporting