DIdirectdigital
Exato - Consultas

Credit analysis — company (CNPJ)

Credit history of a company by CNPJ.

Source: credit bureau data.

Returns: registration data, lines of business, employee count band, credit score, protested bills, overdue debts, stopped and returned cheques (including the Central Bank's CCF), civil lawsuits, previous credit inquiries on the CNPJ and payment behavior indicators.

Execution: synchronous; no PDF.

Note: A section that could not be checked comes back null; an empty list means nothing was found in that section.

post/br/exato/analise-credito/pessoa-juridica

Request

Query parameters

test_modeboolean

true returns simulated data, without querying the source. Queries that do not offer test mode return code 7.

lightweightboolean

Lightweight mode (internal use).

Request body application/x-www-form-urlencoded

cnpjstring required

Company CNPJ, 14 characters, with or without mask. E.g.: 11222333000181.

Response

Success

ApiResultType'Success' | 'SuccessWithRemarks' | 'InvalidInput' | 'DataUnavailable' | 'NotFound' | 'InvalidParameters' | 'UnsupportedCombination' | 'RemoteUnavailable' | 'Timeout' | 'RetryLimitReached' | 'RemoteError' | 'InProgress' | 'InsufficientCredits' | 'ConcurrentLimitReached' | 'TransactionUnavailable' | 'AccessDenied' | 'TransactionCancelled' | 'Created' | 'Updated' | 'Deleted' | 'InternalError' | 'ValidationFailed' | 'Conflict' | 'ResourceLocked' | 'PendingApproval' | 'Approved' | 'Rejected' | 'Cancelled' | 'Paused' | 'Resumed'

New unified result type for queries and administrative operations. Replaces TransactionResultType with better semantics.

BalanceInBrlnumber double

Current balance in BRL.

BalanceInCreditsinteger

Current balance in credits.

DataSourceCategorystring

Data source category

Datestring date-time

Transaction date.

ElapsedTimeInMillisecondsinteger

Execution time (in milliseconds).

ExecutedDataSourceNamestring

Display name of the query type that actually ran.

ExecutedDataSourceTypeIdinteger

Id of the query type that actually ran (the one recorded on the transaction), which may differ from the requested type when the route is generic per state or when a master delegates to a sub-query.

HasOriginalFilesboolean

Indicates that the transaction carries original files from the source (the issued certificate, for example) for download at OriginalFilesUrl. False does not mean the URL does not exist: it is always built.

HasPdfboolean

Indicates that there is a PDF proof document for the result.

Messagestring

Message.

OriginalFilesUrlstring

URL to download the transaction's original files (when available).

OutdatedResultboolean

Indicates that the result is dated.

PdfUrlstring

URL to download the transaction's PDF proof document (when available).

ResultSubtypestring

Specific result subtype to provide additional context (e.g.: 'duplicate_name', 'invalid_cpf').

ResultTypeCodeinteger

Numeric result code (compatible with TransactionResultTypeCode but extensible).

TotalCostnumber double

Internal use only.

TotalCostInCreditsinteger

Total transaction cost in credits.

TransactionResultType'Success' | 'SuccessWithRemarks' | 'InvalidInputData' | 'UnavailableData' | 'EntityNotFound' | 'InvalidParameters' | 'ParametersNotSupported' | 'RemoteSystemUnavailable' | 'Timeout' | 'AttemptsLimitReached' | 'RemoteSystemError' | 'AsyncExecutionInProgress' | 'AwaitingExecution' | 'BirthDateRequired' | 'InsufficientBalance' | 'SimultaneousTransactionsLimitReached' | 'TransactionUnavailable' | 'AccessDenied' | 'TransactionCancelled' | 'InternalError'
<table class="transaction"><thead><tr><th>TransactionResultType Code</th><th>TransactionResultType</th><th>Final</th><th>Billable</th><th>Error</th></tr></thead><tbody><tr><td>1</td><td>Success</td><td>True</td><td>True</td><td>False</td></tr><tr><td>2</td><td>Partial success or success with remarks</td><td>True</td><td>True</td><td>False</td></tr><tr><td>3</td><td>Invalid input or document</td><td>True</td><td>False</td><td>True</td></tr><tr><td>4</td><td>Data not available</td><td>True (for the day)</td><td>False</td><td>False</td></tr><tr><td>5</td><td>Entity or document nonexistent/not found</td><td>True</td><td>True</td><td>False</td></tr><tr><td>6</td><td>Invalid input parameters</td><td>True</td><td>False</td><td>True</td></tr><tr><td>7</td><td>Unsupported parameter combination</td><td>True</td><td>False</td><td>True</td></tr><tr><td>8</td><td>Data source or remote system unavailable</td><td>False</td><td>False</td><td>True</td></tr><tr><td>9</td><td>Time limit exceeded</td><td>False</td><td>False</td><td>True</td></tr><tr><td>10</td><td>Attempts limit reached</td><td>False</td><td>False</td><td>True</td></tr><tr><td>11</td><td>Error in the data source or remote system</td><td>False</td><td>False</td><td>True</td></tr><tr><td>12</td><td>Transaction in progress</td><td>False</td><td>False</td><td>False</td></tr><tr><td>101</td><td>Insufficient credit balance, please contact us</td><td>False</td><td>False</td><td>True</td></tr><tr><td>102</td><td>Simultaneous transactions limit reached, please contact us</td><td>False</td><td>False</td><td>True</td></tr><tr><td>103</td><td>Transaction not available, please contact us</td><td>False</td><td>False</td><td>True</td></tr><tr><td>104</td><td>Invalid credentials or access denied, please contact us</td><td>False</td><td>False</td><td>True</td></tr><tr><td>105</td><td>Transaction cancelled, please contact us</td><td>False</td><td>False</td><td>True</td></tr><tr><td>255*</td><td>Unexpected internal error, please contact us</td><td>True (for the day)</td><td>False</td><td>True</td></tr><tr><td>* Query under maintenance, try again later or contact Exato to report the problem</td></tr></tbody></table>
TransactionResultTypeCodeinteger

Transaction result type code.

UniqueIdentifierstring

Unique transaction identifier. Store it for control and debugging.

Changes

No operation changes recorded.