---
title: US Certificate of Good Standing Extraction API
slug: us-apis/us-certificate-of-good-standing-extraction-api
createdAt: 2024-12-03T17:12:01.849Z
---

# 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

:::CodeblockTabs
Production

```curl
curl --location 'https://api.signzy.us/api/v3/us/cogs-extract' \
--header 'Content-Type: application/json' \
--header 'Authorization: ****' \
--data '
 {
    "fileLink": "<file link >"  
 }
'
```

Pre-Production

```curl
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

```json
{
    "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

:::CodeblockTabs
400 (Invalid Input)

```json
{
    "error": {
        "name": "error",
        "message": "fileLink is an invalid URL",
        "status": 400,
        "reason": "VALIDATION_ERROR",
        "type": "Bad Request",
        "statusCode": "400"
    }
}
```

409 (Upstream Error)

```json
{
    "error": {
        "name": "error",
        "message": "Failed to process PDF ",
        "status": 409,
        "reason": "UPLOAD_ERROR",
        "type": "Conflict",
        "statusCode": "409"
    }
}
```
:::

:::hint{type="info"}
# 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 [help@signzy.com](#). 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!
:::





