POST
/
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,
  "register_court": "<string>",
  "offset": 123,
  "limit": 123,
  "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
      }
    },
    "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
      }
    },
    "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
      }
    },
    "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
      }
    }
  },
  "bypass_cache": true
}'
{
  "companies": [
    {
      "id": "<string>",
      "name": "<string>",
      "slug": "<string>",
      "legal_form": "<string>",
      "register_number": 123,
      "register_court": "<string>",
      "country": "<string>",
      "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 examples

View the comprehensive filtering documentation to understand all supported filter types, operators, and see practical examples for every use case.

​
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 general company filtering with optional time constraints

Response

200
application/json

Successful Response

Model for filter companies endpoint response