US Certificate of Good Standing Extraction API
Overview
The Certificate of Good Standing Extraction API parses state-issued Certificates of Good Standing into structured JSON. These certificates are minimal documents that confirm an entity is legally registered and in good standing with a state authority (e.g., Delaware Secretary of State). The API is designed for KYB and onboarding use cases where institutions need to store evidence of good standing, extract the entity name, and validate the issuing authority and date.
About Certificate of Good Standing Issued by: State Secretary of State (SOS)
Purpose: Certifies that a company is properly formed and currently compliant with state requirements (annual filings, fees).
Contents: Typically only the entity’s legal name, entity type, jurisdiction, issuing authority, issuance date, and a seal/signature.
Usecases
- KYB onboarding: Prove the company is active with the state.
- Banking/Payments: Support account opening or merchant onboarding.
- Regulatory audits: Keep structured records of certificates issued within the last 60–90 days.
- Vendor risk checks: Confirm counterparties are not dissolved or revoked.
API Details
Input
curl --location 'https://api-preproduction.signzy.us/api/v3/us/cogs-extract' \
--header 'Content-Type: application/json' \
--header 'Authorization: ****' \
--data '
{
"fileLink": "<file link >"
}
'API Input Schema
Parameter | Required | Data Type | Description |
|---|---|---|---|
fileLink | required | string | URL of the COGS Document for which the extraction has to be done |
Output
{
"result": {
"issuingAuthority": "Secretary of State of the State of West Virginia",
"jurisdiction": "WV",
"entityLegalName": "**** LLC",
"entityType": "LLC",
"certificateIssueDate": "2018-06-01",
"certificateId": "5XX",
"sealOrSignaturePresent": true
}
}Output Parameters
Parameter | Description | Type |
|---|---|---|
issuingAuthority | The name of the issuing authority that released the certificate | string |
jurisdiction | The state or region under which the entity is registered [two-letter U.S. state code] | string |
entityLegalName | The legal name of the registered entity | string |
entityType | The type of entity registered | string |
certificateIssueDate | The date when the certificate was issued | string (yyyy-mm-dd) |
certificateId | Unique identifier or number of the certificate | string |
sealOrSignaturePresent | Indicates if a government seal or signature is visible on the certificate | boolean |
Error Code
{
"error": {
"name": "error",
"message": "fileLink is an invalid URL",
"status": 400,
"reason": "VALIDATION_ERROR",
"type": "Bad Request",
"statusCode": "400"
}
}Getting help
Please feel free to contact us if you have any questions, require clarification, or have ideas for how to make the documents or any of our services better.
You can reach out to us at [email protected]. We strive to provide prompt and reliable assistance, ensuring your queries are addressed effectively.
We value your feedback and are committed to making your experience smooth and enjoyable. Our team is dedicated to assisting you with any needs you may have.Thank you for choosing our services. We look forward to helping you!