Skip to main content
POST
Buscar proposições legislativas
Os parâmetros base — keywords, q, modes, page, limit, sort e intervalos de data — são os mesmos de todos os endpoints e estão descritos em Conceitos de busca.

Authorizations

x-api-key
string
header
required

Chave de API da Nomos. Clientes criam e gerenciam chaves em https://nomos.pro/organization/developers (Organização → Desenvolvedores).

Query Parameters

page
integer
default:1

Número da página.

Required range: x >= 1
limit
integer
default:10

Resultados por página. Máximo 20.

Required range: 1 <= x <= 20
q
string

Busca por texto livre. Pode ser usada junto com keywords.

modes
string

Modos de busca separados por vírgula. sensitive diferencia maiúsculas e acentos; keyword exige correspondência exata.

sort
enum<string>
default:recently_updated

Ordenação. newest = mais recentes por data; recently_updated = movimentados há menos tempo; older = mais antigos primeiro; relevance = mais aderentes às palavras-chave.

Available options:
newest,
recently_updated,
older,
relevance

Body

application/json

Palavras-chave e filtros do domínio. Todo campo é opcional; um corpo vazio retorna os resultados mais recentes.

keywords
object

Palavras-chave booleanas. Combine os três operadores livremente.

Example:
resources
string[]

Casas legislativas de origem.

Example:
types
string[]

Tipos de proposição.

Example:
situations
string[]

IDs de situação de tramitação (lastProceeding.openDataSituationId). Use apenas IDs reais extraídos de um resultado anterior.

processing
enum<string>[]

Status de tramitação: ["true"] em tramitação, ["false"] arquivadas, ambos para as duas, omitido para todas.

Available options:
true,
false
regimes
string[]

Regimes de tramitação. Deixe vazio para todos.

Example:
appreciations
string[]

Formas de apreciação. Deixe vazio para todas.

Example:
approved
enum<string>[]

Status de aprovação: ["true"] aprovadas, ["false"] rejeitadas, omitido para todas.

Available options:
true,
false
authors
string[]

IDs de stakeholder autor (authors.stakeholderId). Use apenas IDs reais.

rapporteurs
string[]

IDs de stakeholder relator (rapporteurs.stakeholderId). Use apenas IDs reais.

parties
string[]

Siglas partidárias.

Example:
states
string[]

Siglas de unidade federativa.

Example:
organs
string[]

IDs de órgão (lastProceeding.organ.id). Use apenas IDs reais.

themes
string[]

IDs de tema (themes.openDataId). Use apenas IDs reais.

created_at
object

Filtra por data de apresentação.

Example:
updated_at
object

Filtra por data da última movimentação.

Example:

Response

Página de resultados.

Uma página de documentos mais os metadados de paginação.

results
object[]

Documentos encontrados. O formato é específico de cada domínio e evolui ao longo do tempo. Todo item traz link_to_nomos_api, um deep link para o registro no App da Nomos.

pagination
object

Metadados de paginação (page, limit, total).