> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://api-docs.nilo.services/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://api-docs.nilo.services/_mcp/server.

# Buscar por parâmetros

GET https://landing-zone-api.nilo.services/fhir/resources/Appointment

Devolve os agendamentos entre pacientes e profissionais do seu ambiente.

Reference: https://api-docs.nilo.services/referencia/endpoints/appointment/search-by-params

## Authentication

- `x-api-key` header (required) — API Key authentication via header

## Servers

- `https://landing-zone-api.nilo.services` (Production, default)
- `https://landing-zone-api.stg.nilo.services` (Staging)

## Request

### Query parameters

- `identifier` (string, optional) — Identificador do agendamento, na sintaxe `system|value`. Aceita a sua chave ou o identificador Nilo.
- `patient` (string, optional) — Agendamentos de um paciente, pelo `id` Nilo FHIR dele.
- `patient:identifier` (string, optional) — Agendamentos de um paciente, pelo identificador dele embutido na referência.
- `practitioner` (string, optional) — Agendamentos de um profissional, pelo `id` Nilo FHIR dele.
- `practitioner:identifier` (string, optional) — Agendamentos de um profissional, pelo identificador dele.
- `date` (string, optional) — Data do agendamento, comparada com o `start`. Aceita os prefixos `eq`, `ge` e `le`.
- `status` (enum, optional) — Situação do agendamento. Só os seis valores que a plataforma produz aparecem nos resultados.
  - Allowed values: `proposed`, `booked`, `fulfilled`, `cancelled`, `noshow`, `waitlist`
- `appointment-type` (string, optional) — Modalidade, na sintaxe `system|code`.
- `_count` (integer, optional) — Quantidade de registros por página.
- `_lastUpdated` (list of string, optional) — Data de última alteração dos registros que devem ser retornado.

## Response

### 200

Operação bem sucedida.

- `resourceType` (string, required, default: Bundle) — Indica o tipo do recurso transacionado.
- `type` (enum, required) — Constante `searchset` neste endpoint.
  - Allowed values: `searchset`
- `entry` (list of Appointment_Entry, optional) — Uma entrada por agendamento encontrado. Vazia quando não há resultados.
- `link` (list of BundleAppointmentLinkItems, optional) — Navegação do resultado. Havendo próxima página, ela vem pronta em `next`.

## Errors

### 400 Bad Request Error

Parâmetro enviado inválido.

- `issue` (list of OperationOutcomeIssueItems, required) — Uma coleção de mensagens de erro, aviso ou informação que resultado de uma ação do sistema.
- `resourceType` (string, required, default: OperationOutcome) — Indica o tipo do recurso transacionado.

## Types

### Appointment_Entry

Envelope da leitura por `id`. Não é um `Bundle`, mas também não é o recurso nu: o agendamento está em `resource`.

- `fullUrl` (string, required) — URL absoluta do recurso neste ambiente.
- `resource` (Appointment, required) — O agendamento.
- `search` (AppointmentEntrySearch, required) — Constante com `mode` igual a `match`, herdada da forma de busca.

### BundleAppointmentLinkItems

- `relation` (string, optional) — Uma relação conforme a definição RFC8288.
- `url` (string, optional) — Link de referência.

### OperationOutcomeIssueItems

Uma mensagem de erro, aviso ou informação que resultado de uma ação do sistema.

- `code` (enum, optional) — Descreve o tipo do problema.
  - Allowed values: `invalid`, `structure`, `required`, `value`, `invariant`, `security`, `login`, `unknown`, `expired`, `forbidden`, `suppressed`, `processing`, `not-supported`, `duplicate`, `multiple-matches`, `not-found`, `deleted`, `too-long`, `code-invalid`, `extension`, `too-costly`, `business-rule`, `conflict`, `transient`, `lock-error`, `no-store`, `exception`, `timeout`, `incomplete`, `throttled`, `informational`
- `details` (CodeableConcept, optional) — Detalhes adicionais sobre os códigos de resultado da operação de erro.
- `diagnostics` (string, optional) — Informações de diagnóstico adicionais sobre o problema
- `expression` (list of string, optional) — FHIR Path (caminho) do(s) elemento(s) relacionado(s) ao problema.
- `severity` (enum, optional) — Indica o resultado do processamento apesar do problema indicado.
  - Allowed values: `fatal`, `error`, `warning`, `information`

### Appointment

Agendamento entre um paciente e um profissional. Na escrita, cinco dados são obrigatórios; na leitura, o recurso traz também o link da sala de vídeo, quando há.

- `resourceType` (string, required, default: Appointment) — Indica o tipo do recurso transacionado.
- `identifier` (list of Identifier, required) — Suas chaves do agendamento. **Obrigatório na escrita**: é por elas que a API decide entre criar e atualizar. A leitura devolve o seu identificador ao lado do identificador Nilo, no `system` `.../NamingSystem/care-api--scheduling-v2`.
- `status` (string, required) — **Obrigatório.** Na escrita, oito valores são aceitos, mas eles colapsam em quatro situações da plataforma — veja o guia. Na leitura, o valor devolvido é o da situação, não o que você enviou.
- `participant` (list of Appointment_Participant, required) — **Obrigatório**: exatamente **um** participante de tipo `Patient` e **um** de tipo `Practitioner`. Nem zero, nem dois de cada.
- `id` (string, optional) — Só resposta: identificador Nilo FHIR do agendamento.
- `meta` (Meta, optional) — Só resposta: metadados da gravação.
- `start` (string, optional) — **Obrigatório na escrita.** Início previsto do agendamento. Na leitura pode faltar num agendamento cancelado, cujas datas a plataforma às vezes limpa.
- `end` (string, optional) — **Obrigatório na escrita**, e tem de ser maior que o `start`. Na leitura pode faltar num agendamento cancelado.
- `description` (string, optional) — O título do agendamento. Repare que é o `description` do FHIR que guarda o **título** — o texto livre vai no `comment`.
- `comment` (string, optional) — Observações do agendamento, em texto livre. **Omiti-lo numa atualização apaga a observação na plataforma, mas o recurso preserva o valor anterior** — para zerar os dois lados, mande o campo vazio.
- `appointmentType` (Appointment_AppointmentType, optional) — A modalidade do atendimento. Omitido na escrita, o agendamento nasce **online**.
- `extension` (list of AppointmentExtensionItems, optional) — Informações adicionais que não fazem parte da definição básica do recurso. Abaixo estão as extensões usadas no contexto Nilo; extensões externas a esse contexto são ignoradas.
- `created` (string, optional) — Só resposta: quando o agendamento foi criado.
- `contained` (list of Appointment_Endpoint, optional) — Só resposta, e só nos agendamentos online com sala criada: um `Endpoint` cujo `address` é o link da sala de vídeo. A sala é criada de forma assíncrona, depois da resposta do `POST`, e depende de a funcionalidade estar habilitada no seu ambiente.

### AppointmentEntrySearch

Constante com `mode` igual a `match`, herdada da forma de busca.

- `mode` (string, optional)

### CodeableConcept

Um CodeableConcept representa um valor geralmente fornecido como uma referência a terminologias ou ontologias, mas também pode ser definido pelo fornecimento de texto. Esse é um padrão comum em dados de saúde.

- `coding` (list of Coding, optional) — Código definido por um sistema de terminologia.
- `text` (string, optional) — Representação de texto simples do conceito.

### Identifier

Um identificador, código que identifica alguma entidade de forma única e inequívoca. Normalmente, isso é usado para identificadores de negócios.

- `system` (string, required) — O namespace para o valor do identificador. O cliente deve usar o seu próprio namespace.
- `value` (string, required) — O código de identificação único. Cliente deve usar o seu próprio.
- `use` (enum, optional) — A finalidade deste identificador.
  - Allowed values: `usual`, `official`, `temp`, `secondary`, `old`

### Appointment_Participant

Um participante do agendamento.

- `actor` (Appointment_Participant_Actor, required) — O paciente ou o profissional. **Obrigatório**, e o `type` é o que diz qual dos dois é.
- `status` (string, required) — Exigido pelo FHIR e **descartado na escrita**: a leitura devolve sempre `accepted`.

### Meta

Os metadados sobre um recurso. Este conteúdo do recurso é normalmente mantido pelo sistema gestor do registro.

- `lastUpdated` (string, optional) — Um instante no tempo (necessário conhecer pelo menos até o nível de segundos).
- `versionId` (string, optional) — Qualquer combinação de letras, números, "-" e ".", com um limite de 64 caracteres. (Pode ser um número inteiro, um OID não prefixado, UUID ou qualquer outro padrão de identificador que atenda a essas restrições.) Os IDs não diferenciam maiúsculas de minúsculas.

### Appointment_AppointmentType

Modalidade do atendimento.

- `coding` (list of Appointment_AppointmentType_Coding, required) — Só o primeiro item cujo `system` seja o de modalidade da Nilo é lido.

### AppointmentExtensionItems

- Extension-Appointment-allowConflict: Extension-Appointment-allowConflict

### Appointment_Endpoint

A sala de vídeo do agendamento, embutida no recurso. Só resposta.

- `resourceType` (string, optional, default: Endpoint) — Constante `Endpoint`.
- `address` (string, optional) — O link da sala de vídeo.
- `status` (enum, optional) — Constante `active`.
  - Allowed values: `active`
- `connectionType` (Coding, optional) — Constante, com `code` igual a `https`.
- `payloadType` (list of CodeableConcept, optional) — Constante, com `text` igual a `video`.

### Coding

Código definido por um sistema de terminologia.

- `code` (string, optional) — Código de identificação de um termo no sistema terminológico.
- `display` (string, optional) — Representação textual definida pelo sistema terminológico.
- `system` (string, optional) — Identidade do sistema terminológico.

### Appointment_Participant_Actor

Referência ao paciente ou ao profissional.

- `identifier` (Identifier, required) — O identificador do participante — a sua chave ou o identificador Nilo dele.
- `type` (enum, required) — **Obrigatório na escrita**: é o que distingue o paciente do profissional.
  - Allowed values: `Patient`, `Practitioner`
- `reference` (string, optional) — Só resposta: o caminho relativo do participante.

### Appointment_AppointmentType_Coding

Código da modalidade.

- `system` (string, required) — Constante `{host}/fhir/resources/CodeSystem/appointment-type`, com o host do ambiente. Um coding em qualquer outro `system` é **ignorado em silêncio**, e a modalidade cai em online — errar esta URL faz um agendamento presencial virar online sem erro.
- `code` (string, required) — `ONLINE` ou `IN_PERSON`. Qualquer outro código no `system` da Nilo **recusa a chamada**.
- `display` (string, optional) — Só resposta: `Atendimento Online` ou `Atendimento Presencial`.

### Extension-Appointment-allowConflict

Dispensa a conferência da agenda do profissional ao gravar o agendamento. Com `true`, a plataforma deixa de recusar as três situações que confere: colisão com outro compromisso do profissional, horário fora da grade de atendimento dele, e horário já ocupado por outro agendamento do mesmo paciente ou do mesmo profissional. São dispensadas juntas — não há como liberar uma e manter as outras. O agendamento gravado com `true` também **deixa de bloquear** os agendamentos seguintes: outro agendamento no mesmo horário passa a ser aceito sem extensão nenhuma. **Omitida, vale `true`**: o horário que a integração recebe é tratado como decisão já tomada do lado de quem envia. Só um `false` explícito pede a conferência — e nem sempre a obtém: quando a configuração de sobreposição do care provider está habilitada, a plataforma continua permitindo a sobreposição, e a resposta devolve `true`. A extensão vem em **toda** leitura de `Appointment`, com `true` ou com `false`.

- `url` (string, optional, default: https://landing-zone-api.nilo.services/fhir/resources/StructureDefinition/appointment-allowConflict) — Identifica o significado da extensão.
- `valueBoolean` (boolean, optional) — Valor de "verdadeiro" ou "falso".

## Examples

### Busca com resultados

**Response**

```json
{
  "resourceType": "Bundle",
  "type": "searchset",
  "entry": [
    {
      "fullUrl": "https://landing-zone-api.nilo.services/fhir/resources/Appointment/8f30c26b-5d17-4e94-a1c3-70b6e2854f19",
      "resource": {
        "resourceType": "Appointment",
        "identifier": [
          {
            "system": "https://landing-zone-api.nilo.services/fhir/resources/NamingSystem/care-api--scheduling-v2",
            "value": "620914",
            "use": "usual"
          },
          {
            "system": "https://www.acmesaude.com.br/integracao/agendamento/",
            "value": "AG-3001",
            "use": "usual"
          }
        ],
        "status": "booked",
        "participant": [
          {
            "actor": {
              "identifier": {
                "system": "https://www.acmesaude.com.br/integracao/paciente/",
                "value": "507823709",
                "use": "usual"
              },
              "type": "Patient",
              "reference": "Patient/ba200cfa-dae0-46cf-81a0-008e3f7414b4"
            },
            "status": "accepted"
          },
          {
            "actor": {
              "identifier": {
                "system": "https://www.acmesaude.com.br/integracao/profissional/",
                "value": "5032932",
                "use": "usual"
              },
              "type": "Practitioner",
              "reference": "Practitioner/1f30c8b7-45ad-4e62-9c81-73b0e5f24a19"
            },
            "status": "accepted"
          }
        ],
        "id": "8f30c26b-5d17-4e94-a1c3-70b6e2854f19",
        "meta": {
          "lastUpdated": "2026-06-01T09:12:45.208000Z",
          "versionId": "MTc4NjAyMTQ1MjkwNTAwMDM2Nw"
        },
        "start": "2026-06-15T14:00:00+00:00",
        "end": "2026-06-15T14:30:00+00:00",
        "description": "Consulta de retorno — endocrinologia",
        "comment": "Paciente pediu horário no fim da tarde.",
        "appointmentType": {
          "coding": [
            {
              "system": "https://landing-zone-api.nilo.services/fhir/resources/CodeSystem/appointment-type",
              "code": "ONLINE",
              "display": "Atendimento Online"
            }
          ]
        },
        "created": "2026-06-01T09:12:44+00:00",
        "contained": [
          {
            "resourceType": "Endpoint",
            "address": "https://video.nilo.services/r/9f2c41a8",
            "status": "active",
            "connectionType": {
              "code": "https"
            },
            "payloadType": [
              {
                "text": "video"
              }
            ]
          }
        ]
      },
      "search": {
        "mode": "match"
      }
    },
    {
      "fullUrl": "https://landing-zone-api.nilo.services/fhir/resources/Appointment/1d74b8e0-92a6-4c15-830f-4e5a7c93d268",
      "resource": {
        "resourceType": "Appointment",
        "identifier": [
          {
            "system": "https://landing-zone-api.nilo.services/fhir/resources/NamingSystem/care-api--scheduling-v2",
            "value": "620915",
            "use": "usual"
          }
        ],
        "status": "fulfilled",
        "participant": [
          {
            "actor": {
              "identifier": {
                "system": "https://www.acmesaude.com.br/integracao/paciente/",
                "value": "507823709",
                "use": "usual"
              },
              "type": "Patient",
              "reference": "Patient/ba200cfa-dae0-46cf-81a0-008e3f7414b4"
            },
            "status": "accepted"
          },
          {
            "actor": {
              "identifier": {
                "system": "https://www.acmesaude.com.br/integracao/profissional/",
                "value": "5032932",
                "use": "usual"
              },
              "type": "Practitioner",
              "reference": "Practitioner/1f30c8b7-45ad-4e62-9c81-73b0e5f24a19"
            },
            "status": "accepted"
          }
        ],
        "id": "1d74b8e0-92a6-4c15-830f-4e5a7c93d268",
        "meta": {
          "lastUpdated": "2026-06-02T11:40:02.774000Z",
          "versionId": "MTc4NjAyMTQ1MjkwNTAwMDM5OA"
        },
        "start": "2026-06-02T10:00:00+00:00",
        "end": "2026-06-02T10:40:00+00:00",
        "description": "Consulta inicial — nutrição",
        "appointmentType": {
          "coding": [
            {
              "system": "https://landing-zone-api.nilo.services/fhir/resources/CodeSystem/appointment-type",
              "code": "IN_PERSON",
              "display": "Atendimento Presencial"
            }
          ]
        },
        "created": "2026-05-20T15:03:11+00:00"
      },
      "search": {
        "mode": "match"
      }
    }
  ],
  "link": []
}
```

**SDK Code**

```python Busca com resultados
import requests

url = "https://landing-zone-api.nilo.services/fhir/resources/Appointment"

querystring = {"_count":"50","_lastUpdated":"[\"eq2013-01-14\"]","appointment-type":"https://landing-zone-api.nilo.services/fhir/resources/CodeSystem/appointment-type|ONLINE","date":"ge2026-06-01","identifier":"https://www.acmesaude.com.br/integracao/agendamento/|AG-3001","patient":"Patient/ba200cfa-dae0-46cf-81a0-008e3f7414b4","patient:identifier":"https://www.acmesaude.com.br/integracao/paciente/|507823709","practitioner":"Practitioner/1f30c8b7-45ad-4e62-9c81-73b0e5f24a19","practitioner:identifier":"https://www.acmesaude.com.br/integracao/profissional/|5032932","status":"booked"}

headers = {"x-api-key": "<apiKey>"}

response = requests.get(url, headers=headers, params=querystring)

print(response.json())
```

```javascript Busca com resultados
const url = 'https://landing-zone-api.nilo.services/fhir/resources/Appointment?_count=50&_lastUpdated=%5B%22eq2013-01-14%22%5D&appointment-type=https%3A%2F%2Flanding-zone-api.nilo.services%2Ffhir%2Fresources%2FCodeSystem%2Fappointment-type%7CONLINE&date=ge2026-06-01&identifier=https%3A%2F%2Fwww.acmesaude.com.br%2Fintegracao%2Fagendamento%2F%7CAG-3001&patient=Patient%2Fba200cfa-dae0-46cf-81a0-008e3f7414b4&patient%3Aidentifier=https%3A%2F%2Fwww.acmesaude.com.br%2Fintegracao%2Fpaciente%2F%7C507823709&practitioner=Practitioner%2F1f30c8b7-45ad-4e62-9c81-73b0e5f24a19&practitioner%3Aidentifier=https%3A%2F%2Fwww.acmesaude.com.br%2Fintegracao%2Fprofissional%2F%7C5032932&status=booked';
const options = {method: 'GET', headers: {'x-api-key': '<apiKey>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go Busca com resultados
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://landing-zone-api.nilo.services/fhir/resources/Appointment?_count=50&_lastUpdated=%5B%22eq2013-01-14%22%5D&appointment-type=https%3A%2F%2Flanding-zone-api.nilo.services%2Ffhir%2Fresources%2FCodeSystem%2Fappointment-type%7CONLINE&date=ge2026-06-01&identifier=https%3A%2F%2Fwww.acmesaude.com.br%2Fintegracao%2Fagendamento%2F%7CAG-3001&patient=Patient%2Fba200cfa-dae0-46cf-81a0-008e3f7414b4&patient%3Aidentifier=https%3A%2F%2Fwww.acmesaude.com.br%2Fintegracao%2Fpaciente%2F%7C507823709&practitioner=Practitioner%2F1f30c8b7-45ad-4e62-9c81-73b0e5f24a19&practitioner%3Aidentifier=https%3A%2F%2Fwww.acmesaude.com.br%2Fintegracao%2Fprofissional%2F%7C5032932&status=booked"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<apiKey>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby Busca com resultados
require 'uri'
require 'net/http'

url = URI("https://landing-zone-api.nilo.services/fhir/resources/Appointment?_count=50&_lastUpdated=%5B%22eq2013-01-14%22%5D&appointment-type=https%3A%2F%2Flanding-zone-api.nilo.services%2Ffhir%2Fresources%2FCodeSystem%2Fappointment-type%7CONLINE&date=ge2026-06-01&identifier=https%3A%2F%2Fwww.acmesaude.com.br%2Fintegracao%2Fagendamento%2F%7CAG-3001&patient=Patient%2Fba200cfa-dae0-46cf-81a0-008e3f7414b4&patient%3Aidentifier=https%3A%2F%2Fwww.acmesaude.com.br%2Fintegracao%2Fpaciente%2F%7C507823709&practitioner=Practitioner%2F1f30c8b7-45ad-4e62-9c81-73b0e5f24a19&practitioner%3Aidentifier=https%3A%2F%2Fwww.acmesaude.com.br%2Fintegracao%2Fprofissional%2F%7C5032932&status=booked")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<apiKey>'

response = http.request(request)
puts response.read_body
```

```java Busca com resultados
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.get("https://landing-zone-api.nilo.services/fhir/resources/Appointment?_count=50&_lastUpdated=%5B%22eq2013-01-14%22%5D&appointment-type=https%3A%2F%2Flanding-zone-api.nilo.services%2Ffhir%2Fresources%2FCodeSystem%2Fappointment-type%7CONLINE&date=ge2026-06-01&identifier=https%3A%2F%2Fwww.acmesaude.com.br%2Fintegracao%2Fagendamento%2F%7CAG-3001&patient=Patient%2Fba200cfa-dae0-46cf-81a0-008e3f7414b4&patient%3Aidentifier=https%3A%2F%2Fwww.acmesaude.com.br%2Fintegracao%2Fpaciente%2F%7C507823709&practitioner=Practitioner%2F1f30c8b7-45ad-4e62-9c81-73b0e5f24a19&practitioner%3Aidentifier=https%3A%2F%2Fwww.acmesaude.com.br%2Fintegracao%2Fprofissional%2F%7C5032932&status=booked")
  .header("x-api-key", "<apiKey>")
  .asString();
```

```php Busca com resultados
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://landing-zone-api.nilo.services/fhir/resources/Appointment?_count=50&_lastUpdated=%5B%22eq2013-01-14%22%5D&appointment-type=https%3A%2F%2Flanding-zone-api.nilo.services%2Ffhir%2Fresources%2FCodeSystem%2Fappointment-type%7CONLINE&date=ge2026-06-01&identifier=https%3A%2F%2Fwww.acmesaude.com.br%2Fintegracao%2Fagendamento%2F%7CAG-3001&patient=Patient%2Fba200cfa-dae0-46cf-81a0-008e3f7414b4&patient%3Aidentifier=https%3A%2F%2Fwww.acmesaude.com.br%2Fintegracao%2Fpaciente%2F%7C507823709&practitioner=Practitioner%2F1f30c8b7-45ad-4e62-9c81-73b0e5f24a19&practitioner%3Aidentifier=https%3A%2F%2Fwww.acmesaude.com.br%2Fintegracao%2Fprofissional%2F%7C5032932&status=booked', [
  'headers' => [
    'x-api-key' => '<apiKey>',
  ],
]);

echo $response->getBody();
```

```csharp Busca com resultados
using RestSharp;

var client = new RestClient("https://landing-zone-api.nilo.services/fhir/resources/Appointment?_count=50&_lastUpdated=%5B%22eq2013-01-14%22%5D&appointment-type=https%3A%2F%2Flanding-zone-api.nilo.services%2Ffhir%2Fresources%2FCodeSystem%2Fappointment-type%7CONLINE&date=ge2026-06-01&identifier=https%3A%2F%2Fwww.acmesaude.com.br%2Fintegracao%2Fagendamento%2F%7CAG-3001&patient=Patient%2Fba200cfa-dae0-46cf-81a0-008e3f7414b4&patient%3Aidentifier=https%3A%2F%2Fwww.acmesaude.com.br%2Fintegracao%2Fpaciente%2F%7C507823709&practitioner=Practitioner%2F1f30c8b7-45ad-4e62-9c81-73b0e5f24a19&practitioner%3Aidentifier=https%3A%2F%2Fwww.acmesaude.com.br%2Fintegracao%2Fprofissional%2F%7C5032932&status=booked");
var request = new RestRequest(Method.GET);
request.AddHeader("x-api-key", "<apiKey>");
IRestResponse response = client.Execute(request);
```

```swift Busca com resultados
import Foundation

let headers = ["x-api-key": "<apiKey>"]

let request = NSMutableURLRequest(url: NSURL(string: "https://landing-zone-api.nilo.services/fhir/resources/Appointment?_count=50&_lastUpdated=%5B%22eq2013-01-14%22%5D&appointment-type=https%3A%2F%2Flanding-zone-api.nilo.services%2Ffhir%2Fresources%2FCodeSystem%2Fappointment-type%7CONLINE&date=ge2026-06-01&identifier=https%3A%2F%2Fwww.acmesaude.com.br%2Fintegracao%2Fagendamento%2F%7CAG-3001&patient=Patient%2Fba200cfa-dae0-46cf-81a0-008e3f7414b4&patient%3Aidentifier=https%3A%2F%2Fwww.acmesaude.com.br%2Fintegracao%2Fpaciente%2F%7C507823709&practitioner=Practitioner%2F1f30c8b7-45ad-4e62-9c81-73b0e5f24a19&practitioner%3Aidentifier=https%3A%2F%2Fwww.acmesaude.com.br%2Fintegracao%2Fprofissional%2F%7C5032932&status=booked")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "GET"
request.allHTTPHeaderFields = headers

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```

### Busca sem resultados

**Response**

```json
{
  "resourceType": "Bundle",
  "type": "searchset",
  "entry": [],
  "link": []
}
```

**SDK Code**

```python Busca sem resultados
import requests

url = "https://landing-zone-api.nilo.services/fhir/resources/Appointment"

querystring = {"_count":"50","_lastUpdated":"[\"eq2013-01-14\"]","appointment-type":"https://landing-zone-api.nilo.services/fhir/resources/CodeSystem/appointment-type|ONLINE","date":"ge2026-06-01","identifier":"https://www.acmesaude.com.br/integracao/agendamento/|AG-3001","patient":"Patient/ba200cfa-dae0-46cf-81a0-008e3f7414b4","patient:identifier":"https://www.acmesaude.com.br/integracao/paciente/|507823709","practitioner":"Practitioner/1f30c8b7-45ad-4e62-9c81-73b0e5f24a19","practitioner:identifier":"https://www.acmesaude.com.br/integracao/profissional/|5032932","status":"booked"}

headers = {"x-api-key": "<apiKey>"}

response = requests.get(url, headers=headers, params=querystring)

print(response.json())
```

```javascript Busca sem resultados
const url = 'https://landing-zone-api.nilo.services/fhir/resources/Appointment?_count=50&_lastUpdated=%5B%22eq2013-01-14%22%5D&appointment-type=https%3A%2F%2Flanding-zone-api.nilo.services%2Ffhir%2Fresources%2FCodeSystem%2Fappointment-type%7CONLINE&date=ge2026-06-01&identifier=https%3A%2F%2Fwww.acmesaude.com.br%2Fintegracao%2Fagendamento%2F%7CAG-3001&patient=Patient%2Fba200cfa-dae0-46cf-81a0-008e3f7414b4&patient%3Aidentifier=https%3A%2F%2Fwww.acmesaude.com.br%2Fintegracao%2Fpaciente%2F%7C507823709&practitioner=Practitioner%2F1f30c8b7-45ad-4e62-9c81-73b0e5f24a19&practitioner%3Aidentifier=https%3A%2F%2Fwww.acmesaude.com.br%2Fintegracao%2Fprofissional%2F%7C5032932&status=booked';
const options = {method: 'GET', headers: {'x-api-key': '<apiKey>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go Busca sem resultados
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://landing-zone-api.nilo.services/fhir/resources/Appointment?_count=50&_lastUpdated=%5B%22eq2013-01-14%22%5D&appointment-type=https%3A%2F%2Flanding-zone-api.nilo.services%2Ffhir%2Fresources%2FCodeSystem%2Fappointment-type%7CONLINE&date=ge2026-06-01&identifier=https%3A%2F%2Fwww.acmesaude.com.br%2Fintegracao%2Fagendamento%2F%7CAG-3001&patient=Patient%2Fba200cfa-dae0-46cf-81a0-008e3f7414b4&patient%3Aidentifier=https%3A%2F%2Fwww.acmesaude.com.br%2Fintegracao%2Fpaciente%2F%7C507823709&practitioner=Practitioner%2F1f30c8b7-45ad-4e62-9c81-73b0e5f24a19&practitioner%3Aidentifier=https%3A%2F%2Fwww.acmesaude.com.br%2Fintegracao%2Fprofissional%2F%7C5032932&status=booked"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<apiKey>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby Busca sem resultados
require 'uri'
require 'net/http'

url = URI("https://landing-zone-api.nilo.services/fhir/resources/Appointment?_count=50&_lastUpdated=%5B%22eq2013-01-14%22%5D&appointment-type=https%3A%2F%2Flanding-zone-api.nilo.services%2Ffhir%2Fresources%2FCodeSystem%2Fappointment-type%7CONLINE&date=ge2026-06-01&identifier=https%3A%2F%2Fwww.acmesaude.com.br%2Fintegracao%2Fagendamento%2F%7CAG-3001&patient=Patient%2Fba200cfa-dae0-46cf-81a0-008e3f7414b4&patient%3Aidentifier=https%3A%2F%2Fwww.acmesaude.com.br%2Fintegracao%2Fpaciente%2F%7C507823709&practitioner=Practitioner%2F1f30c8b7-45ad-4e62-9c81-73b0e5f24a19&practitioner%3Aidentifier=https%3A%2F%2Fwww.acmesaude.com.br%2Fintegracao%2Fprofissional%2F%7C5032932&status=booked")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<apiKey>'

response = http.request(request)
puts response.read_body
```

```java Busca sem resultados
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.get("https://landing-zone-api.nilo.services/fhir/resources/Appointment?_count=50&_lastUpdated=%5B%22eq2013-01-14%22%5D&appointment-type=https%3A%2F%2Flanding-zone-api.nilo.services%2Ffhir%2Fresources%2FCodeSystem%2Fappointment-type%7CONLINE&date=ge2026-06-01&identifier=https%3A%2F%2Fwww.acmesaude.com.br%2Fintegracao%2Fagendamento%2F%7CAG-3001&patient=Patient%2Fba200cfa-dae0-46cf-81a0-008e3f7414b4&patient%3Aidentifier=https%3A%2F%2Fwww.acmesaude.com.br%2Fintegracao%2Fpaciente%2F%7C507823709&practitioner=Practitioner%2F1f30c8b7-45ad-4e62-9c81-73b0e5f24a19&practitioner%3Aidentifier=https%3A%2F%2Fwww.acmesaude.com.br%2Fintegracao%2Fprofissional%2F%7C5032932&status=booked")
  .header("x-api-key", "<apiKey>")
  .asString();
```

```php Busca sem resultados
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://landing-zone-api.nilo.services/fhir/resources/Appointment?_count=50&_lastUpdated=%5B%22eq2013-01-14%22%5D&appointment-type=https%3A%2F%2Flanding-zone-api.nilo.services%2Ffhir%2Fresources%2FCodeSystem%2Fappointment-type%7CONLINE&date=ge2026-06-01&identifier=https%3A%2F%2Fwww.acmesaude.com.br%2Fintegracao%2Fagendamento%2F%7CAG-3001&patient=Patient%2Fba200cfa-dae0-46cf-81a0-008e3f7414b4&patient%3Aidentifier=https%3A%2F%2Fwww.acmesaude.com.br%2Fintegracao%2Fpaciente%2F%7C507823709&practitioner=Practitioner%2F1f30c8b7-45ad-4e62-9c81-73b0e5f24a19&practitioner%3Aidentifier=https%3A%2F%2Fwww.acmesaude.com.br%2Fintegracao%2Fprofissional%2F%7C5032932&status=booked', [
  'headers' => [
    'x-api-key' => '<apiKey>',
  ],
]);

echo $response->getBody();
```

```csharp Busca sem resultados
using RestSharp;

var client = new RestClient("https://landing-zone-api.nilo.services/fhir/resources/Appointment?_count=50&_lastUpdated=%5B%22eq2013-01-14%22%5D&appointment-type=https%3A%2F%2Flanding-zone-api.nilo.services%2Ffhir%2Fresources%2FCodeSystem%2Fappointment-type%7CONLINE&date=ge2026-06-01&identifier=https%3A%2F%2Fwww.acmesaude.com.br%2Fintegracao%2Fagendamento%2F%7CAG-3001&patient=Patient%2Fba200cfa-dae0-46cf-81a0-008e3f7414b4&patient%3Aidentifier=https%3A%2F%2Fwww.acmesaude.com.br%2Fintegracao%2Fpaciente%2F%7C507823709&practitioner=Practitioner%2F1f30c8b7-45ad-4e62-9c81-73b0e5f24a19&practitioner%3Aidentifier=https%3A%2F%2Fwww.acmesaude.com.br%2Fintegracao%2Fprofissional%2F%7C5032932&status=booked");
var request = new RestRequest(Method.GET);
request.AddHeader("x-api-key", "<apiKey>");
IRestResponse response = client.Execute(request);
```

```swift Busca sem resultados
import Foundation

let headers = ["x-api-key": "<apiKey>"]

let request = NSMutableURLRequest(url: NSURL(string: "https://landing-zone-api.nilo.services/fhir/resources/Appointment?_count=50&_lastUpdated=%5B%22eq2013-01-14%22%5D&appointment-type=https%3A%2F%2Flanding-zone-api.nilo.services%2Ffhir%2Fresources%2FCodeSystem%2Fappointment-type%7CONLINE&date=ge2026-06-01&identifier=https%3A%2F%2Fwww.acmesaude.com.br%2Fintegracao%2Fagendamento%2F%7CAG-3001&patient=Patient%2Fba200cfa-dae0-46cf-81a0-008e3f7414b4&patient%3Aidentifier=https%3A%2F%2Fwww.acmesaude.com.br%2Fintegracao%2Fpaciente%2F%7C507823709&practitioner=Practitioner%2F1f30c8b7-45ad-4e62-9c81-73b0e5f24a19&practitioner%3Aidentifier=https%3A%2F%2Fwww.acmesaude.com.br%2Fintegracao%2Fprofissional%2F%7C5032932&status=booked")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "GET"
request.allHTTPHeaderFields = headers

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```