Medications - JSON Export Format

Documentation for medications structure in JSON exports

Last updated: February 6, 2026

On this page

Medicamentos

Os dados de medicamentos incluem todos os medicamentos que você adicionou ao Apple Health, incluindo medicamentos agendados, dosagens, informações de adesão e detalhes dos medicamentos. Nas exportações JSON, os medicamentos são armazenados no array medications.

Disponibilidade

A exportação de medicamentos está disponível no iOS 26.0 e posteriores. Se você estiver usando uma versão anterior do iOS, este tipo de dados não estará disponível em suas exportações.

Estrutura

Cada entrada de medicamento inclui informações abrangentes sobre o medicamento, seu cronograma e adesão:

{
  "displayText": "Aspirin",
  "nickname": "Daily Aspirin",
  "start": "2024-01-01 08:00:00 -0800",
  "end": null,
  "scheduledDate": "2024-02-06 08:00:00 -0800",
  "form": "Tablet",
  "status": "Taken",
  "isArchived": false,
  "dosage": 81,
  "codings": [
    {
      "code": "1191",
      "system": "http://www.nlm.nih.gov/research/umls/rxnorm",
      "version": null
    }
  ]
}

Campos

Informações Básicas

  • displayText (String): O nome de exibição do medicamento (ex.: "Aspirin", "Lisinopril")
  • nickname (String | undefined): Apelido opcional que você atribuiu ao medicamento
  • form (String): Forma física do medicamento. Valores possíveis:
    • "Capsule"
    • "Cream"
    • "Device"
    • "Drops"
    • "Foam"
    • "Gel"
    • "Inhaler"
    • "Injection"
    • "Liquid"
    • "Lotion"
    • "Ointment"
    • "Patch"
    • "Powder"
    • "Spray"
    • "Suppository"
    • "Tablet"
    • "Topical"
    • "Unknown"

Datas

  • start (Date): Data e hora em que você começou a tomar este medicamento no formato yyyy-MM-dd HH:mm:ss Z
  • end (Date | undefined): Data e hora em que você parou de tomar este medicamento (null se ainda estiver ativo)
  • scheduledDate (Date | undefined): Data e hora em que o medicamento está agendado para ser tomado

Status e Adesão

  • status (String): Status atual da entrada do medicamento. Valores possíveis:
    • "Not Interacted" - Nenhuma interação registrada
    • "Notification Not Sent" - A notificação não foi enviada
    • "Snoozed" - O lembrete do medicamento foi adiado
    • "Taken" - O medicamento foi tomado
    • "Skipped" - O medicamento foi pulado
    • "Not Logged" - Nenhuma ação de registro foi realizada
    • "Unspecified" - O status não está especificado

Informações Adicionais

  • isArchived (Boolean): Se o medicamento foi arquivado (não é mais rastreado ativamente)
  • dosage (Number | undefined): Quantidade da dosagem (as unidades dependem do medicamento)
  • codings (Array): Array de informações de codificação do medicamento para identificação padronizada

Codificação de Medicamentos

O array codings contém identificadores padronizados de medicamentos:

{
  "codings": [
    {
      "code": "1191",
      "system": "http://www.nlm.nih.gov/research/umls/rxnorm",
      "version": null
    }
  ]
}

Campos de Codificação:

  • code (String): O identificador do código do medicamento
  • system (String): O sistema de codificação usado (ex.: RxNorm, NDC)
  • version (String | undefined): Versão opcional do sistema de codificação

Exemplos de Entradas

Medicamento Ativo

{
  "displayText": "Lisinopril",
  "nickname": "Blood Pressure Med",
  "start": "2023-06-01 08:00:00 -0800",
  "end": null,
  "scheduledDate": "2024-02-06 08:00:00 -0800",
  "form": "Tablet",
  "status": "Taken",
  "isArchived": false,
  "dosage": 10,
  "codings": [
    {
      "code": "29046",
      "system": "http://www.nlm.nih.gov/research/umls/rxnorm",
      "version": null
    }
  ]
}

Medicamento Descontinuado

{
  "displayText": "Antibiotic",
  "nickname": null,
  "start": "2024-01-15 12:00:00 -0800",
  "end": "2024-01-22 12:00:00 -0800",
  "scheduledDate": "2024-01-22 12:00:00 -0800",
  "form": "Capsule",
  "status": "Taken",
  "isArchived": true,
  "dosage": 500,
  "codings": []
}

Entrada de Medicamento Agendada

{
  "displayText": "Multivitamin",
  "nickname": null,
  "start": "2024-01-01 07:00:00 -0800",
  "end": null,
  "scheduledDate": "2024-02-06 07:00:00 -0800",
  "form": "Tablet",
  "status": "Not Logged",
  "isArchived": false,
  "dosage": 1,
  "codings": []
}

Compreendendo os Valores de Status

O campo status ajuda a rastrear a adesão aos medicamentos:

  • "Taken": O medicamento foi tomado com sucesso
  • "Skipped": O medicamento foi intencionalmente pulado
  • "Snoozed": O lembrete foi adiado (pode indicar ingestão atrasada)
  • "Not Logged": Nenhuma ação foi registrada (pode indicar dose perdida)
  • "Not Interacted": Nenhuma interação com o lembrete

Casos de Uso

Os dados de medicamentos podem ser úteis para:

  • Rastreamento de adesão: Monitorar a consistência com que os medicamentos são tomados
  • Registros médicos: Manter um histórico completo de medicamentos
  • Compartilhamento com provedores de saúde: Compartilhar listas de medicamentos com médicos
  • Análise de interações medicamentosas: Cruzar referências com outros dados de saúde
  • Relatórios de conformidade: Gerar relatórios sobre adesão a medicamentos

Documentação Relacionada