List ICSR Cases

Retrieve a paginated list of ICSR cases with filtering and search capabilities

GET /api/v1/icsr

List ICSR Cases

cURL

curl --request GET \
  --url https://api.example.com/api/v1/icsr

200

{
  "items": [
    {
      "id": 123,
      "created_at": "<string>",
      "paciente_iniciales": "<string>",
      "paciente_edad": 123,
      "paciente_sexo": "<string>",
      "paciente_peso": 123,
      "reportante_nombre": "<string>",
      "reportante_email": "<string>",
      "reportante_telefono": "<string>",
      "producto_sospechoso": "<string>",
      "fecha_inicio_evento": "<string>",
      "fecha_fin_evento": "<string>",
      "descripcion_evento": "<string>",
      "gravedad": "<string>",
      "estado": "<string>",
      "numero": "<string>",
      "ea_causalidad": "<string>",
      "ea_desenlace": "<string>",
      "productos": [
        {}
      ],
      "concomitantes": [
        {}
      ],
      "seguimientos": [
        {}
      ],
      "eventos": [
        {}
      ]
    }
  ],
  "total": 123,
  "page": 123,
  "page_size": 123
}

Endpoint

GET /api/v1/icsr

Authentication

Requires permission: icsr:list

Query Parameters

page · integer · default: "1"

Page number for pagination (minimum: 1)

page_size · integer · default: "20"

Number of items per page (minimum: 1, maximum: 200)

q · string

Full-text search query. Searches across:

• Patient initials
• Case number
• Product names
• Event descriptions
• Reporter name
• Internal codes

fecha_desde · string

Filter cases with event start date on or after this date (ISO format: YYYY-MM-DD). Alias: date_from

fecha_hasta · string

Filter cases with event start date on or before this date (ISO format: YYYY-MM-DD). Alias: date_to

order_by · string · default: "id"

Field to sort by. Common values:

• id - Case ID
• created_at - Creation timestamp
• fecha_inicio_evento - Event start date
• gravedad - Severity
• estado - Status

order_dir · string · default: "desc"

Sort direction:

• asc - Ascending order
• desc - Descending order (default, showing newest first)

Response

items · array

Array of ICSR case objects

Show ICSR Object Schema

id · integer

Unique case identifier

created_at · string

Case creation timestamp

paciente_iniciales · string

Patient initials

paciente_edad · integer

Patient age

paciente_sexo · string

Patient sex (M/F/O)

paciente_peso · number

Patient weight in kg

reportante_nombre · string

Reporter name

reportante_email · string

Reporter email

reportante_telefono · string

Reporter phone

producto_sospechoso · string

Suspected product name

fecha_inicio_evento · string

Event start date

fecha_fin_evento · string

Event end date

descripcion_evento · string

Event narrative description

gravedad · string

Severity classification

estado · string

Case status (e.g., “Pendiente”, “En progreso”, “Cerrado”)

numero · string

Case number/reference

ea_causalidad · string

Causality assessment

ea_desenlace · string

Event outcome

productos · array

Array of suspected product objects with full details

concomitantes · array

Array of concomitant medication objects

seguimientos · array

Array of followup entry objects

eventos · array

Array of adverse event objects with MedDRA coding

total · integer

Total number of cases matching the filters (not just the current page)

page · integer

Current page number

page_size · integer

Number of items per page

Example Requests

Basic Listing (First Page)

GET /api/v1/icsr?page=1&page_size=20

Search by Patient Initials

GET /api/v1/icsr?q=JD&page=1&page_size=20

Filter by Date Range

GET /api/v1/icsr?fecha_desde=2024-01-01&fecha_hasta=2024-01-31

Search with Custom Sort

GET /api/v1/icsr?q=amoxicilina&order_by=gravedad&order_dir=asc

Large Page Size

GET /api/v1/icsr?page=1&page_size=100

Example Response

{
  "items": [
    {
      "id": 1234,
      "created_at": "2024-01-20T10:30:00Z",
      "paciente_iniciales": "JD",
      "paciente_edad": 45,
      "paciente_sexo": "M",
      "paciente_peso": 72.5,
      "reportante_nombre": "Dr. Maria Garcia",
      "reportante_email": "[e-mail]",
      "producto_sospechoso": "Amoxicilina 500mg",
      "fecha_inicio_evento": "2024-01-15",
      "fecha_fin_evento": "2024-01-18",
      "descripcion_evento": "Paciente desarrolló rash eritematoso generalizado...",
      "gravedad": "No grave",
      "estado": "Cerrado",
      "numero": "ICSR-2024-001",
      "ea_causalidad": "Probable",
      "ea_desenlace": "Recuperado",
      "productos": [
        {
          "id": 5678,
          "nombre_producto": "Amoxicilina",
          "ifa": "Amoxicilina trihidratada",
          "registro_sanitario": "EE-123456",
          "nro_lote": "LOT2024-001",
          "via_administracion": "Oral",
          "dosis_frecuencia": "500mg cada 8 horas"
        }
      ],
      "concomitantes": [],
      "seguimientos": [],
      "eventos": [
        {
          "id": 9012,
          "icsr_id": 1234,
          "texto": "Rash eritematoso generalizado",
          "gravedad": "No grave",
          "causalidad": "Probable",
          "desenlace": "Recuperado",
          "meddra_pt_code": "10037844",
          "meddra_pt_term": "Rash"
        }
      ]
    },
    {
      "id": 1233,
      "created_at": "2024-01-19T14:22:00Z",
      "paciente_iniciales": "AB",
      "paciente_edad": 32,
      "paciente_sexo": "F",
      "reportante_nombre": "Dr. Carlos Lopez",
      "producto_sospechoso": "Ibuprofeno 400mg",
      "fecha_inicio_evento": "2024-01-18",
      "descripcion_evento": "Paciente presentó dolor epigástrico severo...",
      "gravedad": "Grave",
      "estado": "En progreso",
      "ea_causalidad": "Posible",
      "productos": [
        {
          "id": 5677,
          "nombre_producto": "Ibuprofeno",
          "ifa": "Ibuprofeno",
          "forma_farmaceutica": "Tableta"
        }
      ],
      "concomitantes": [],
      "seguimientos": [],
      "eventos": []
    }
  ],
  "total": 156,
  "page": 1,
  "page_size": 20
}

Pagination Calculation

To calculate total pages:

const totalPages = Math.ceil(response.total / response.page_size);

To check if there’s a next page:

const hasNextPage = response.page * response.page_size < response.total;

Search Behavior

The q parameter performs case-insensitive partial matching across multiple fields:

• Patient: initials, DNI
• Case: number, internal code, CENAFYT code
• Product: suspected product name, product array names
• Event: description/narrative
• Reporter: name, email

Search is optimized for performance with database indexing on key fields.

Date Filtering

Date filters apply to the fecha_inicio_evento field:

• fecha_desde is inclusive (>=)
• fecha_hasta is inclusive (<=)
• Both can be used together for a range
• Dates must be in ISO format (YYYY-MM-DD)

Sorting

Available sort fields:

• id - Numeric case ID (default)
• created_at - Creation timestamp
• fecha_inicio_evento - Event start date
• gravedad - Severity (alphabetical)
• estado - Status (alphabetical)
• paciente_iniciales - Patient initials (alphabetical)

Default sort is id DESC (newest cases first).

Performance Notes

• List queries are optimized with database indexes
• Large page sizes (>100) may impact performance
• The response includes complete nested objects (products, events, etc.)
• For minimal data transfer, consider implementing a “list” endpoint that returns only summary fields

Error Responses

400 Bad Request

{
  "detail": "page must be >= 1"
}

or

{
  "detail": "page_size must be between 1 and 200"
}

401 Unauthorized

{
  "detail": "Not authenticated"
}

403 Forbidden

{
  "detail": "Permission denied: icsr:list required"
}

Related Endpoints

• Get Case Details - Retrieve a single case with enriched data
• Create Case - Create a new ICSR
• Bulk Duplicate Check - Check duplicates for multiple cases