> 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 ID

GET https://landing-zone-api.nilo.services/fhir/resources/Task/{id}

Reference: https://api-docs.nilo.services/referencia/endpoints/task/search-by-id

## 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

### Path parameters

- `id` (string, required) — Identificador Nilo Fhir do registro que deve ser retornado.

## Response

### 200

Operação bem sucedida.

- `fullUrl` (string, required) — URL absoluta do recurso neste ambiente.
- `resource` (Task, required) — A tarefa.
- `search` (TaskEntrySearch, optional) — Constante com `mode` igual a `match`, herdada da forma de busca.

## 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.

### 404 Not Found Error

Não existe tarefa com o `id` informado — inclusive quando ela existia e foi removida na plataforma.

- `any`

## Types

### Task

Uma tarefa atribuída a alguém no acompanhamento de um paciente. Duas coisas diferentes chegam aqui com a mesma forma: a tarefa da equipe de cuidado e o questionário atribuído ao paciente. `code.text` e o `system` do `identifier` dizem qual é qual. É um recurso somente leitura — a plataforma o produz, e esta API não tem caminho de escrita para ele.

- `description` (string, required) — O que deve ser feito. Na tarefa da equipe é o texto escrito por quem a criou; no questionário do paciente é o nome do questionário, ou a palavra `Questionário` quando o nome não está disponível.
- `for` (Reference, required) — O paciente a que a tarefa se refere.
- `identifier` (list of Identifier, required) — Identificador Nilo da tarefa, em um único item. O `system` diz de qual das duas origens ela vem: `…/NamingSystem/cogsworth-api--to-do` na tarefa da equipe e `…/NamingSystem/hippocrates-api--patient-questionnaire` no questionário do paciente. Este recurso nunca carrega identificadores do seu sistema.
- `intent` (string, required) — Constante `order`. Não distingue nada e não vale filtrar por ele.
- `resourceType` (string, required, default: Task) — Indica o tipo do recurso transacionado.
- `status` (string, required) — O andamento da tarefa. Só três dos valores do FHIR são produzidos, e não há como distinguir uma tarefa cancelada de uma tarefa aberta.
- `authoredOn` (string, optional) — Data de criação da tarefa, sem hora. Só na tarefa da equipe — o questionário do paciente não traz este campo.
- `code` (CodeableConcept, optional) — O que a tarefa é, em `text` e sem `coding`. Na tarefa da equipe é o tipo de tarefa configurado pelo cliente; no questionário do paciente é a constante `patient-questionnaire`.
- `executionPeriod` (Period, optional) — Na tarefa da equipe, `start` repete a data de criação e `end` só existe depois de concluída — datas sem hora. No questionário do paciente é o período de vigência, com hora, e `end` pode vir antes de o questionário ser respondido. Não é o prazo da tarefa da equipe: esse está em `restriction.period.end`.
- `id` (string, optional) — Identificador Nilo FHIR do recurso, usado na leitura por ID.
- `lastModified` (string, optional) — Última alteração da tarefa. Na tarefa da equipe vem só a data; no questionário do paciente vem data e hora.
- `meta` (Meta, optional) — Metadados da gravação no store — versão e data da última alteração.
- `note` (list of Annotation, optional) — As anotações de andamento da tarefa, uma por item, com o texto em `text` e o momento em `time` — este com data **e hora**, ao contrário das outras datas desta origem. Só na tarefa da equipe.
- `output` (list of Task_Output, optional) — O questionário atribuído e a resposta dele, um item cada, distinguidos por `type.text` (`questionnaire` e `questionnaire-response`). Só no questionário do paciente, e ausente enquanto não houver nenhum dos dois.
- `owner` (Reference, optional) — O profissional responsável por executar a tarefa. Só na tarefa da equipe — o questionário do paciente não traz responsável, mesmo quando a plataforma tem um.
- `performerType` (list of CodeableConcept, optional) — A especialidade do responsável, em `text` e sem `coding`. Vem em um único item, com a **primeira** especialidade dele. Só na tarefa da equipe.
- `priority` (string, optional) — A prioridade da tarefa. Só na tarefa da equipe. A correspondência com os níveis da plataforma não é a que o nome do código sugere — veja a página do guia.
- `requester` (Reference, optional) — O profissional que solicitou a tarefa. Só na tarefa da equipe, e ausente nas criadas automaticamente por uma diretriz.
- `restriction` (Task_Restriction, optional) — O prazo da tarefa, em `period.end`. Só na tarefa da equipe. `period.start` nunca vem preenchido.

### TaskEntrySearch

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

- `mode` (string, optional)

### 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`

### Reference

Uma referência de um recurso para outro.

- `identifier` (Identifier, required) — Um identificador, código que identifica alguma entidade de forma única e inequívoca. Normalmente, isso é usado para identificadores de negócios.
- `type` (string, required) — Indica o tipo do recurso referenciado.
- `display` (string, optional) — Alternativa textual para descrever a referência.
- `reference` (string, optional) — Referência direta.

### 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`

### 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.

### Period

Um intervalo de tempo definido por uma data de início e término e, opcionalmente, horas para ambos.

- `end` (string, optional) — Uma data, data-hora ou data parcial (por exemplo, apenas ano ou ano + mês).
- `start` (string, optional) — Uma data, data-hora ou data parcial (por exemplo, apenas ano ou ano + mês).

### 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.

### Annotation

Uma nota de texto que também contém informações sobre quem fez o declaração e quando.

- `authorReference` (Reference, optional) — O indivíduo responsável por fazer a anotação.
- `text` (string, optional) — O conteúdo da anotação.
- `time` (string, optional) — Quando a anotação foi feita.

### Task_Output

Um resultado produzido pela tarefa. Só o questionário do paciente traz esta lista, com dois itens: o questionário atribuído e, depois de respondido, a resposta dele.

- `type` (CodeableConcept, required) — Qual dos dois resultados é este, em `text`: `questionnaire` para o questionário atribuído, `questionnaire-response` para a resposta.
- `valueReference` (Reference, optional) — O recurso apontado. Vem por identificador, sem `reference` — diferente das outras referências deste recurso.

### Task_Restriction

Condições limitantes da tarefa. Desta estrutura a plataforma preenche apenas o prazo, em `period.end`.

- `period` (Period, optional) — O prazo da tarefa em `end`. `start` nunca vem preenchido — o começo da execução está em `executionPeriod.start`.

### 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.

## Examples

**Response**

```json
{
  "fullUrl": "https://landing-zone-api.nilo.services/fhir/resources/Task/7e51c8b3-2f04-4d97-a6b1-83ce0f24d7a5",
  "resource": {
    "description": "Ligar para confirmar a retirada da medicação na farmácia.",
    "for": {
      "identifier": {
        "system": "https://www.acmesaude.com.br/integracao/paciente/",
        "value": "507823709",
        "use": "usual"
      },
      "type": "Patient",
      "reference": "Patient/8b1d0e94-6a37-4c52-9f81-2ad7e6c40b13"
    },
    "identifier": [
      {
        "system": "https://landing-zone-api.nilo.services/fhir/resources/NamingSystem/cogsworth-api--to-do",
        "value": "41827",
        "use": "usual"
      }
    ],
    "intent": "order",
    "resourceType": "Task",
    "status": "in-progress",
    "authoredOn": "2026-05-23",
    "code": {
      "text": "Ligação de acompanhamento"
    },
    "executionPeriod": {
      "start": "2026-05-23"
    },
    "id": "7e51c8b3-2f04-4d97-a6b1-83ce0f24d7a5",
    "lastModified": "2026-05-28",
    "meta": {
      "lastUpdated": "2026-05-28T13:41:07.402000Z",
      "versionId": "MTc4NjAyMTQ1MjkwNTAwNTIxNA"
    },
    "note": [
      {
        "authorReference": {
          "identifier": {
            "system": "https://www.acmesaude.com.br/integracao/profissional/",
            "value": "5032932",
            "use": "usual"
          },
          "type": "Practitioner",
          "reference": "Practitioner/6d92f7c1-84be-4a03-91d7-5fe28b6c04a9"
        },
        "text": "Paciente não atendeu na primeira tentativa; retornar depois das 18h.",
        "time": "2026-05-27T14:12:39+00:00"
      }
    ],
    "owner": {
      "identifier": {
        "system": "https://www.acmesaude.com.br/integracao/profissional/",
        "value": "5032932",
        "use": "usual"
      },
      "type": "Practitioner",
      "reference": "Practitioner/6d92f7c1-84be-4a03-91d7-5fe28b6c04a9"
    },
    "performerType": [
      {
        "text": "Enfermagem"
      }
    ],
    "priority": "urgent",
    "requester": {
      "identifier": {
        "system": "https://www.acmesaude.com.br/integracao/profissional/",
        "value": "5048117",
        "use": "usual"
      },
      "type": "Practitioner",
      "reference": "Practitioner/2c47a980-31fd-4e6b-8a05-9db1c7e35f26"
    },
    "restriction": {
      "period": {
        "end": "2026-06-05"
      }
    }
  },
  "search": {
    "mode": "match"
  }
}
```

**SDK Code**

```python Tarefa encontrada
import requests

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

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

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

print(response.json())
```

```javascript Tarefa encontrada
const url = 'https://landing-zone-api.nilo.services/fhir/resources/Task/id';
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 Tarefa encontrada
package main

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

func main() {

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

	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 Tarefa encontrada
require 'uri'
require 'net/http'

url = URI("https://landing-zone-api.nilo.services/fhir/resources/Task/id")

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 Tarefa encontrada
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/Task/id")
  .header("x-api-key", "<apiKey>")
  .asString();
```

```php Tarefa encontrada
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://landing-zone-api.nilo.services/fhir/resources/Task/id', [
  'headers' => [
    'x-api-key' => '<apiKey>',
  ],
]);

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

```csharp Tarefa encontrada
using RestSharp;

var client = new RestClient("https://landing-zone-api.nilo.services/fhir/resources/Task/id");
var request = new RestRequest(Method.GET);
request.AddHeader("x-api-key", "<apiKey>");
IRestResponse response = client.Execute(request);
```

```swift Tarefa encontrada
import Foundation

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

let request = NSMutableURLRequest(url: NSURL(string: "https://landing-zone-api.nilo.services/fhir/resources/Task/id")! 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()
```