---
title: "Create a new MerQube security_list"
method: POST
path: "/security_list"
tags: ["security_list"]
---

# Create a new MerQube security_list

`POST /security_list`

## Request

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

Create a new MerQube security_list

## Request body

- SecurityListPost: represents a list of securities
  - `name` string, required: unique name among all other security lists
  - `namespace` string
  - `realtime` boolean
  - `securities` object[], required
    - `identifier_type` 'RIC' | 'secapi_name', required
    - `identifier_value` string, required
    - `security_type` string, required

## Response `200`

OK

- object
  - `id` string: the uuid of this security_list
  - `status` string

## Other responses

- `400`: illegal request body
- `403`: not authorized to perform this operation

---

[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)