GET
/
blocked-companies
List blocked companies
curl --request GET \
  --url https://api.godiligent.ai/blocked-companies \
  --header 'X-API-KEY: <api-key>'
[
  {
    "id": "bc-a91a8416-0a38",
    "website": "example.com",
    "email": "contact@example.com",
    "legal_name": "Example Company Ltd",
    "address": "123 Example Street, City",
    "country_code": "DE",
    "vat_number": "BE09999999XX",
    "register_number": "123456789",
    "reason": "Fraudulent activity",
    "notes": "Multiple reports of fraud from customers",
    "blocked_at": "2025-01-15T12:30:45Z",
    "external_id": "cust-12345"
  }
]

Authorizations

​
X-API-KEY
string
header
required

Query Parameters

​
register_number
string

Filter by register_number

Response

List of blocked companies

​
id
string
required

Unique identifier for the blocked company record

Example:

"bc-a91a8416-0a38"

​
reason
string
required

The reason for blocking the company

Example:

"Fraudulent activity"

​
blocked_at
string<date-time>
required

When the company was blocked

Example:

"2025-01-15T12:30:45Z"

​
website
string | null

The website of the business (if provided)

Example:

"example.com"

​
email
string | null

The email of the business (if provided)

Example:

"contact@example.com"

​
legal_name
string | null

The legal name of the business (if provided)

Example:

"Example Company Ltd"

​
address
string | null

The address of the business (if provided)

Example:

"123 Example Street, City"

​
country_code
string | null

Country code in ISO 3166-1 alpha-2 format (if provided)

Example:

"DE"

​
vat_number
string | null

The VAT number of the business (if provided)

Example:

"BE09999999XX"

​
register_number
string | null

The registry number of the business (if provided)

Example:

"123456789"

​
notes
string | null

Additional notes about the block

Example:

"Multiple reports of fraud from customers"

​
external_id
string | null

Reference ID from the customer's system (if provided)

Example:

"cust-12345"