POST
/
filter
/
companies
Filter Companies
curl --request POST \
  --url https://jobs-api.registercheck.de/api/v2/filter/companies \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "days": 123,
  "start_date": "2023-12-25",
  "end_date": "2023-12-25",
  "register_court": "<string>",
  "offset": 0,
  "limit": 10,
  "filters": {
    "company": {
      "name": {
        "operator": "<string>",
        "value": "<string>",
        "values": [
          "<any>"
        ],
        "min": 123,
        "max": 123
      },
      "legal_form": {
        "operator": "<string>",
        "value": "<string>",
        "values": [
          "<any>"
        ],
        "min": 123,
        "max": 123
      },
      "register_court": {
        "operator": "<string>",
        "value": "<string>",
        "values": [
          "<any>"
        ],
        "min": 123,
        "max": 123
      },
      "register_prefix": {
        "operator": "<string>",
        "value": "<string>",
        "values": [
          "<any>"
        ],
        "min": 123,
        "max": 123
      },
      "register_number": {
        "operator": "<string>",
        "value": "<string>",
        "values": [
          "<any>"
        ],
        "min": 123,
        "max": 123
      },
      "is_active": {
        "operator": "<string>",
        "value": "<string>",
        "values": [
          "<any>"
        ],
        "min": 123,
        "max": 123
      },
      "is_kg": {
        "operator": "<string>",
        "value": "<string>",
        "values": [
          "<any>"
        ],
        "min": 123,
        "max": 123
      },
      "location": {
        "operator": "within_radius",
        "center_lat": 123,
        "center_lng": 123,
        "radius_meters": 123
      },
      "wkz_codes": {
        "operator": "<string>",
        "value": "<string>",
        "values": [
          "<any>"
        ],
        "min": 123,
        "max": 123
      }
    },
    "company_meta_data": {
      "headquarter": {
        "operator": "<string>",
        "value": "<string>",
        "values": [
          "<any>"
        ],
        "min": 123,
        "max": 123
      },
      "full_address": {
        "operator": "<string>",
        "value": "<string>",
        "values": [
          "<any>"
        ],
        "min": 123,
        "max": 123
      },
      "city": {
        "operator": "<string>",
        "value": "<string>",
        "values": [
          "<any>"
        ],
        "min": 123,
        "max": 123
      },
      "state": {
        "operator": "<string>",
        "value": "<string>",
        "values": [
          "<any>"
        ],
        "min": 123,
        "max": 123
      },
      "country": {
        "operator": "<string>",
        "value": "<string>",
        "values": [
          "<any>"
        ],
        "min": 123,
        "max": 123
      },
      "company_purpose": {
        "operator": "<string>",
        "value": "<string>",
        "values": [
          "<any>"
        ],
        "min": 123,
        "max": 123
      },
      "share_capital": {
        "operator": "<string>",
        "value": "<string>",
        "values": [
          "<any>"
        ],
        "min": 123,
        "max": 123
      }
    },
    "shareholders": {
      "company_id": {
        "operator": "<string>",
        "value": "<string>",
        "values": [
          "<any>"
        ],
        "min": 123,
        "max": 123
      },
      "person_id": {
        "operator": "<string>",
        "value": "<string>",
        "values": [
          "<any>"
        ],
        "min": 123,
        "max": 123
      },
      "name": {
        "operator": "<string>",
        "value": "<string>",
        "values": [
          "<any>"
        ],
        "min": 123,
        "max": 123
      },
      "shareholder_type": {
        "operator": "<string>",
        "value": "<string>",
        "values": [
          "<any>"
        ],
        "min": 123,
        "max": 123
      },
      "percentage_share": {
        "operator": "<string>",
        "value": "<string>",
        "values": [
          "<any>"
        ],
        "min": 123,
        "max": 123
      },
      "is_entitled": {
        "operator": "<string>",
        "value": "<string>",
        "values": [
          "<any>"
        ],
        "min": 123,
        "max": 123
      }
    },
    "representatives": {
      "company_id": {
        "operator": "<string>",
        "value": "<string>",
        "values": [
          "<any>"
        ],
        "min": 123,
        "max": 123
      },
      "person_id": {
        "operator": "<string>",
        "value": "<string>",
        "values": [
          "<any>"
        ],
        "min": 123,
        "max": 123
      },
      "name": {
        "operator": "<string>",
        "value": "<string>",
        "values": [
          "<any>"
        ],
        "min": 123,
        "max": 123
      },
      "first_name": {
        "operator": "<string>",
        "value": "<string>",
        "values": [
          "<any>"
        ],
        "min": 123,
        "max": 123
      },
      "last_name": {
        "operator": "<string>",
        "value": "<string>",
        "values": [
          "<any>"
        ],
        "min": 123,
        "max": 123
      },
      "age": {
        "operator": "<string>",
        "value": "<string>",
        "values": [
          "<any>"
        ],
        "min": 123,
        "max": 123
      },
      "birth_date": {
        "operator": "<string>",
        "value": "<string>",
        "values": [
          "<any>"
        ],
        "min": 123,
        "max": 123
      }
    },
    "limited_partners": {
      "company_id": {
        "operator": "<string>",
        "value": "<string>",
        "values": [
          "<any>"
        ],
        "min": 123,
        "max": 123
      },
      "person_id": {
        "operator": "<string>",
        "value": "<string>",
        "values": [
          "<any>"
        ],
        "min": 123,
        "max": 123
      },
      "name": {
        "operator": "<string>",
        "value": "<string>",
        "values": [
          "<any>"
        ],
        "min": 123,
        "max": 123
      },
      "first_name": {
        "operator": "<string>",
        "value": "<string>",
        "values": [
          "<any>"
        ],
        "min": 123,
        "max": 123
      },
      "last_name": {
        "operator": "<string>",
        "value": "<string>",
        "values": [
          "<any>"
        ],
        "min": 123,
        "max": 123
      },
      "age": {
        "operator": "<string>",
        "value": "<string>",
        "values": [
          "<any>"
        ],
        "min": 123,
        "max": 123
      },
      "birth_date": {
        "operator": "<string>",
        "value": "<string>",
        "values": [
          "<any>"
        ],
        "min": 123,
        "max": 123
      }
    },
    "prokura": {
      "person_id": {
        "operator": "<string>",
        "value": "<string>",
        "values": [
          "<any>"
        ],
        "min": 123,
        "max": 123
      },
      "first_name": {
        "operator": "<string>",
        "value": "<string>",
        "values": [
          "<any>"
        ],
        "min": 123,
        "max": 123
      },
      "last_name": {
        "operator": "<string>",
        "value": "<string>",
        "values": [
          "<any>"
        ],
        "min": 123,
        "max": 123
      },
      "age": {
        "operator": "<string>",
        "value": "<string>",
        "values": [
          "<any>"
        ],
        "min": 123,
        "max": 123
      },
      "birth_date": {
        "operator": "<string>",
        "value": "<string>",
        "values": [
          "<any>"
        ],
        "min": 123,
        "max": 123
      }
    }
  },
  "bypass_cache": false
}'
{
  "companies": [
    {
      "id": "<string>",
      "name": "<string>",
      "slug": "<string>",
      "legal_form": "<string>",
      "register_number": 123,
      "register_prefix": "<string>",
      "register_court": "<string>",
      "country": "<string>",
      "status": "ACTIVE",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z"
    }
  ],
  "pagination": {
    "total": 123,
    "offset": 123,
    "limit": 123
  },
  "applied_filters": {
    "days": 123,
    "register_court": "<string>",
    "filters_applied": true
  }
}

​
Filter Object Documentation

This endpoint accepts an optional filters parameter that enables advanced filtering across multiple data entities. The filter system supports complex queries across company information, metadata, relationships, and geographic data.

📖 Complete Filtering Guide

Learn about all available filters, operators, and examplesView the comprehensive filtering documentation to understand all supported filter types, operators, and see practical examples for every use case.

​
Root‑Level Date Parameters (days, start_date, end_date)

Need to limit results to recent or specific founding dates? Use these root‑level date parameter
ParameterTypeRequiredDescription
daysIntegerNo¹Return companies founded within the last N days counting back from today.
start_dateString (YYYY‑MM‑DD)No¹Inclusive lower bound for founding date.
end_dateString (YYYY‑MM‑DD)No¹Inclusive upper bound for founding date.
¹ Supply either days or (start_date & end_date).

​
Usage Rules

  • Top‑level only – add them as top‑level keys (i.e., sibling properties of filters), don’t nest them inside the filters object.
  • If end_date is present it must be ≥ start_date.
  • Omit all three parameters if you don’t need a founding‑date filter.

​
Quick Date Examples

​
Companies Founded in the Last 30 Days

{
  "offset": 0,
  "limit": 50,
  "days": 30,
  "filters": {
    "company": {
      "is_active": {"operator": "eq", "value": true}
    }
  }
}

​
Companies Founded Between Two Dates

{
  "offset": 0,
  "limit": 50,
  "start_date": "2025-01-01",
  "end_date":   "2025-06-30",
  "filters": {
    "company": {
      "city": {"operator": "eq", "value": "Berlin"}
    }
  }
}

​
Quick Filter Examples

​
Basic Company Filter

{
  "offset": 0,
  "limit": 50,
  "filters": {
    "company": {
      "legal_form": {
        "operator": "eq",
        "value": "GmbH"
      },
      "is_active": {
        "operator": "eq",
        "value": true
      }
    }
  }
}

​
Geographic + Metadata Filter

{
  "offset": 0,
  "limit": 50,
  "filters": {
    "company": {
      "location": {
        "operator": "within_radius",
        "center_lat": 48.1351,
        "center_lng": 11.5820,
        "radius_meters": 5000
      }
    },
    "company_meta_data": {
      "share_capital": {
        "operator": "gte",
        "value": 25000
      }
    }
  }
}

​
Relationship Filter

{
  "offset": 0,
  "limit": 50,
  "filters": {
    "shareholders": {
      "company_id": {
        "operator": "eq",
        "value": "2b902e97-266e-4415-9342-59e8aaf101fd"
      }
    }
  }
}

​
Supported Filter Types

  • Company: Basic company information (name, legal form, register details, location)
  • Company Metadata: Extended data (address, purpose, share capital)
  • Shareholders: Company ownership relationships
  • Representatives: Management and representation relationships
  • Limited Partners: Partnership relationships
  • Prokura: Power of attorney relationships
Need more examples? Check out the complete filtering documentation for detailed explanations, all available operators, and comprehensive examples for every filter type.

Authorizations

​
Authorization
string
header
required

Enter your API key

Body

application/json

Request model for filtering companies

Response

200
application/json

Successful Response

Model for filter companies endpoint response