> For the complete documentation index, see [llms.txt](https://docs.supria.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.supria.com/devs/api-de-consulta/como-consultar-dados.md).

# Como consultar dados

A API do Supria Workspaces segue o padrão OData, o que significa que você pode filtrar, escolher campos e ordenar os resultados diretamente pela URL da chamada, sem precisar de nenhuma ferramenta extra.

### Parâmetros disponíveis

* $filter — filtra os registros por uma condição. Exemplo: $filter=Status eq 'Ativo'
* $select — escolhe quais campos devem vir na resposta. Exemplo: $select=Name,Status
* $orderby — ordena os resultados por um ou mais campos. Exemplo: $orderby=StartDate desc
* $top — limita quantos registros voltam na resposta. Exemplo: $top=50
* $skip — pula um número de registros, útil para paginação. Exemplo: $skip=50
* $expand — traz junto dados de uma tabela relacionada. Exemplo: $expand=Tasks
* $count — inclui a contagem total de itens na resposta. Exemplo: $count=true
* $search — busca itens por frases de pesquisa. Exemplo: $search="contrato importante"

### Combinando parâmetros

Os parâmetros podem ser combinados na mesma chamada. Exemplo: filtrar, ordenar e paginar projetos ativos em uma única requisição:

```
GET /_api/Projects?$filter=Status eq 'Ativo'&$orderby=StartDate desc&$top=20&$skip=0&$count=true

```

Quando há mais resultados do que os retornados, a resposta inclui o campo @odata.nextLink com a URL da próxima página. Com $count=true, a resposta também traz @odata.count com o total de registros que atendem ao filtro.