oneapi
Sign in
Mediu v1 / Mediu

Search the catalogue

Filters on interval, magnitude, depth, solution quality and, optionally, a geographic radius.

GET
https://oneapi.ro/api/mediu/v1/seism/cauta

Query parameters

NameTypeDescriptionAccepted values
de_laoptional string | null First date included, YYYY-MM-DD. e.g. 1977-01-01
pana_laoptional string | null Last date included, YYYY-MM-DD. e.g. 1977-12-31
magnitudine_minoptional number | null Minimum magnitude. 0 – 10
magnitudine_maxoptional number | null Maximum magnitude. 0 – 10
adancime_minoptional number | null Minimum depth, in kilometres. 0 – 1000
adancime_maxoptional number | null Maximum depth, in kilometres. 0 – 1000
calitateoptional string | null Solution class: A, B, C or D. ABCD
raza_kmoptional number | null Radius of the geographic filter, in kilometres. Requires a centre: either lat+lng, or siruta. 1 – 1000
latoptional number | null Latitude of the geographic filter centre. Requires lng and raza_km. 41 – 50
lngoptional number | null Longitude of the centre. Requires lat and raza_km. 19 – 32
sirutaoptional integer | null The SIRUTA code of a locality or LAU, used as the centre of the geographic filter — an alternative to lat+lng. Resolved the same way as at /seism/langa: the locality point, falling back to the LAU centroid. A code that cannot be resolved returns an error, not the whole country. 1
per_paginaoptional text Events per page, maximum 500. Defaults to 50. e.g. 100
paginaoptional text The page, counted from 1. e.g. 1

How it behaves

  • Depth separates two distinct seismic regimes in Romania: crustal earthquakes (below 30 km), local with concentrated effects, and the Vrancea intermediate-depth ones (70–200 km), felt across huge areas. A depth filter is not a technical detail — it separates two phenomena.
  • The geographic filter is optional, but needs a centre AND a radius. The centre comes in two forms: lat+lng or siruta. A radius without a centre, a centre without a radius, or a SIRUTA code that cannot be resolved return 422 rather than a seemingly filtered result.
  • Magnitude and depth filters exclude events where the value is not determined — 339 without magnitude, 3,453 without depth.
  • Pagination is via pagina and per_pagina; meta.paginare.total reports how many events match the filters, independently of the page.

What it is for

  • Extract every event in a period for a study or report, with pagination.
  • Isolate crustal earthquakes from intermediate-depth ones, which behave completely differently in Romania.
  • Filter on solution quality when you only need well-constrained locations.

Response structure

FieldTypeDescription
data.evenimente[].cod string Cheia publică a evenimentului: momentul originii compactat, AAAALLZZTHHMMSS.
data.evenimente[].data_ora string Momentul originii, în UTC. La evenimentele istorice ora poate fi o convenție (00:00:00), nu o observație.
data.evenimente[].an integer Anul, util la filtrare și grupare.
data.evenimente[].latitudine number Latitudinea epicentrului (WGS84).
data.evenimente[].longitudine number Longitudinea epicentrului (WGS84).
data.evenimente[].adancime_km number Adâncimea focarului, în kilometri. null când sursa nu a determinat-o.
data.evenimente[].adancime_fixata boolean true dacă adâncimea a fost FIXATĂ de analist, nu determinată din date. Sunt 6.839 de astfel de evenimente — tratează-le altfel într-o analiză.
data.evenimente[].magnitudine number Magnitudinea de lucru: Mw dacă există, altfel ML, altfel MD. null la 339 de evenimente.
data.evenimente[].tip_magnitudine string Scara din care provine magnitudine: Mw, ML sau MD. Nu compara valori între scări diferite fără s-o iei în seamă.
data.evenimente[].magnitudini object Every determined magnitude, by scale, each with its error.
data.evenimente[].magnitudini.Mw number Magnitudinea moment, dacă e determinată.
data.evenimente[].magnitudini.Mw_eroare number Incertitudinea Mw.
data.evenimente[].magnitudini.ML number Magnitudinea locală (Richter), dacă e determinată.
data.evenimente[].magnitudini.ML_eroare number Incertitudinea ML.
data.evenimente[].magnitudini.MD number Magnitudinea de durată, dacă e determinată.
data.evenimente[].magnitudini.MD_eroare number Incertitudinea MD.
data.evenimente[].solutie object Location quality: horizontal error, RMS, error ellipse, number of phases and stations, azimuthal gap and quality class.
data.evenimente[].solutie.eroare_orizontala_km number Eroarea orizontală a localizării.
data.evenimente[].solutie.rms number Reziduul RMS al soluției.
data.evenimente[].solutie.elipsa_smaj_km number Semiaxa mare a elipsei de eroare.
data.evenimente[].solutie.elipsa_smin_km number Semiaxa mică a elipsei de eroare.
data.evenimente[].solutie.elipsa_azimut integer Azimutul elipsei de eroare, în grade.
data.evenimente[].solutie.nr_faze integer Câte faze seismice au intrat în soluție.
data.evenimente[].solutie.nr_statii integer Câte stații au contribuit.
data.evenimente[].solutie.nr_magnitudini integer Câte determinări de magnitudine s-au mediat.
data.evenimente[].solutie.gap_azimutal integer Cel mai mare unghi fără stații, în grade. Peste ~180° localizarea e slab constrânsă.
data.evenimente[].solutie.calitate string Clasa de calitate a soluției, A–D, așa cum o atribuie INFP.
data.sursa object The ROMPLUS catalogue of the National Institute for Earth Physics, with its licence.
data.sursa.nume string Catalogul și instituția care îl publică.
data.sursa.url string Pagina oficială a catalogului.
data.sursa.licenta string Temeiul reutilizării.
meta.paginare.pagina integer Current page, counted from 1.
meta.paginare.per_pagina integer How many records a page holds.
meta.paginare.total integer Total matching records, beyond the current page.
meta.paginare.pagini integer How many pages the list has.

Response examples

GEThttps://oneapi.ro/api/mediu/v1/seism/cauta?de_la=1977-01-01&pana_la=1977-12-31&magnitudine_min=5
{
    "data": {
        "evenimente": [
            {
                "cod": "19770304T192154",
                "data_ora": "1977-03-04 21: 21: 54+02",
                "an": 1977,
                "latitudine": 45.77,
                "longitudine": 26.76,
                "adancime_km": 94,
                "adancime_fixata": false,
                "magnitudine": 7.4,
                "tip_magnitudine": "Mw",
                "magnitudini": {
                    "Mw": 7.4
                },
                "solutie": {
                    "calitate": "B"
                }
            }
        ],
        "sursa": {
            "nume": "Catalogul ROMPLUS — Institutul Naţional de Cercetare-Dezvoltare pentru Fizica Pământului (INCDFP)",
            "url": "https://www.infp.ro/index.php?i=romplus",
            "licenta": "Date de sector public, reutilizabile conform Legii 109/2007, cu indicarea sursei."
        }
    },
    "meta": {
        "paginare": {
            "pagina": 1,
            "per_pagina": 50,
            "total": 1,
            "pagini": 1
        }
    }
}

Error codes

CodeSlugWhen it occurs
401neautentificatToken missing, invalid, expired or revoked.
403feature_indisponibilThe current plan does not include the feature the route depends on.
422validareRadius without coordinates, coordinates without radius, unknown quality class, or values outside their ranges.
429cota_depasitaThe plan's monthly quota has been exceeded (see Retry-After).

All errors share the same shape. eroare.cod is stable and is the value you should branch on in code — not the text in mesaj, which may change.

{
    "eroare": {
        "cod": "validare",
        "mesaj": "Radius without coordinates, coordinates without radius, unknown quality class, or values outside their ranges.",
        "detalii": {
            "de_la": [
                "The value sent does not satisfy the parameter rule."
            ]
        }
    }
}