> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trybrein.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Api implementation contract

# API implementation contract notes

Created at UTC: 2026-08-13T00:25:32.476670+00:00

## Facet style

Use exact-match filters for low-cardinality values. Use normalized exact plus fuzzy/trigram matching for high-cardinality entity names.

## Tenders

Exact facets:

* source\_slug
* status
* is\_open
* contracting\_type
* procedure\_type
* announcement\_character
* state\_name
* actionability

Date filters:

* published\_date
* clarification\_date
* opening\_date
* award\_date
* actionable\_as\_of

Text search:

* title
* description
* buyer\_name

## Awards

Exact facets:

* source\_slug
* currency
* amount\_scope
* contracting\_type
* contract\_status
* supplier\_country
* supplier\_size
* is\_mipyme
* procedure\_type

Range filters:

* amount, but require/strongly encourage currency and amount\_scope companion filters.

Entity search:

* supplier\_rfc exact normalized.
* supplier\_name and buyer\_name exact normalized plus fuzzy/trigram.

## Directory

Exact/source-level facets:

* source\_slug
* observed\_kind
* state\_code
* state\_name
* municipality
* has\_website

JSONB metadata:

* business\_contacts supports safe metadata facets: kind, classification, source\_field.
* raw business contact values should not be exposed in profile artifacts.
* DENUE is coverage-only in this package.