---
title: "get one or more metrics for one or more securities"
method: GET
path: "/security/{type}"
tags: ["security"]
---

# get one or more metrics for one or more securities

`GET /security/{type}`

## Request

- Base URL: `https://api.merqube.com`
- URL: `https://api.merqube.com/security/{type}`
- Auth: none declared
- TypeScript: <https://skmtc.dev/merqube/apis/merqube-api/docs/security/:type/get.ts> (a function with typed inputs; its response is checked against the schema)

get one or more metrics for one or more securities

## Query parameters

- `name` string
- `names` string
- `id` string
- `ids` string
- `metrics` string
- `securityfilter` string
- `namespace` string
- `start_date` union
  - string, date-time
  - string, date
  - string
- `end_date` union
  - string, date-time
  - string, date
  - string
- `format` 'csv'
- `as_of` string: should be a date-time as a string; YYYY-mm-dd HH-mm-ss
- `since` string: should be a date-time as a string; YYYY-mm-dd HH-mm-ss
- `raw` boolean
- `show_full_history` boolean
- `debug` 'true'
- `validated_only` boolean
- `prefer_read_replica` boolean

## Response `200`

ok

- object
  - `error_codes` ErrorCodes
    - `code` string
    - `message` string
  - `results` SecurityMetrics[]
    - `eff_ts` union, required
      - string, date-time
      - string, date
      - string
    - `id` string, required
    - `lineage` object: data lineage information, for MerQube use only.
    - `metric` string, required
    - `prov_ts` union, required
      - string, date-time
      - string, date
      - string
    - `source` string
    - `value` union, required
      - string
      - number
      - integer
      - boolean
      - unknown[]
        - unknown
      - object

## Other responses

- `403`: not authorized

---

[API](https://skmtc.dev/merqube/apis/merqube-api.md) - [All operations](https://skmtc.dev/merqube/apis/merqube-api/llms.txt) - [OpenAPI document](https://skmtc.dev/merqube/apis/merqube-api/revisions/20f47ca36587?raw)