---
updatedAt: 2026-06-02T21:08:59.000Z
agentTools:
  projectIndex: https://docs.bridgeft.com/llms.txt
---

# List all Security Reference Records

Returns a list of normalized custodian reported securities enriched with Intrinio Market data for a provided `reported_date`

**Example Records**

Below is an example of two security records reported by Schwab, the first is a standard `AAPL` stock and below that
is an AAPL option. Option records will have additional data points populated that provided specific information about
the option as reported by the custodian.

```json
[
  {
    "reported_date": "2024-07-10",
    "source": "SWB",
    "cusip": "037833100",
    "symbol": "AAPL",
    "description": "APPLE INC ",
    "security_type": "COM",
    "security_type_description": "COMMON STOCK",
    "option_root_symbol": "",
    "option_expiration_date": "",
    "option_code": "",
    "strike_price_amount": 0,
    "market_data": {
        "symbol": "AAPL",
        "description": "Apple Inc",
        "figi": "BBG000B9Y5X2",
        "composite_figi": "BBG000B9XRY4",
        "security_type": "Ordinary Shares",
        "security_code": "EQS",
        "security_code_description": "Equity Shares"
    }
  },
  {
    "reported_date": "2024-07-10",
    "source": "SWB",
    "cusip": "",
    "symbol": "AAPL",
    "description": "CALL APPLE INC $195        EXP 09/19/25",
    "security_type": "OEQ",
    "security_type_description": "EQUITY OPTION",
    "option_root_symbol": "AAPL",
    "option_expiration_date": "2025-09-19",
    "option_code": "C",
    "strike_price_amount": 195,
    "market_data": {
        "symbol": "AAPL",
        "description": "Apple Inc",
        "figi": "BBG000B9Y5X2",
        "composite_figi": "BBG000B9XRY4",
        "security_type": "Ordinary Shares",
        "security_code": "EQS",
        "security_code_description": "Equity Shares"
    }
  }
]
```


# OpenAPI definition

````json
{
  "openapi": "3.0.3",
  "info": {
    "title": "Wealthtech API",
    "description": "RESTful API for controlling and interacting with Atlas data",
    "version": "2.6.0"
  },
  "servers": [
    {
      "url": "https://api.bridgeft.com/v2"
    }
  ],
  "x-readme": {
    "explorer-enabled": false,
    "proxy-enabled": true,
    "samples-enabled": true
  },
  "paths": {
    "/jobs/": {
      "get": {
        "tags": [
          "Jobs"
        ],
        "summary": "List all Jobs",
        "description": "Returns a list of jobs",
        "operationId": "getJobs",
        "parameters": [
          {
            "$ref": "#/components/parameters/limit"
          },
          {
            "$ref": "#/components/parameters/page"
          }
        ],
        "responses": {
          "200": {
            "description": "An enveloped list of Jobs",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "object": {
                      "type": "string",
                      "example": "list"
                    },
                    "has_next": {
                      "type": "boolean"
                    },
                    "has_previous": {
                      "type": "boolean"
                    },
                    "current_page": {
                      "type": "integer",
                      "example": 2
                    },
                    "total_pages": {
                      "type": "integer",
                      "example": 5
                    },
                    "page_size_limit": {
                      "type": "integer",
                      "example": 10000
                    },
                    "total_items": {
                      "type": "integer",
                      "example": 50
                    },
                    "data": {
                      "$ref": "#/components/schemas/Jobs"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/data/custodian/securities/reference": {
      "post": {
        "tags": [
          "Security Reference"
        ],
        "summary": "List all Security Reference Records",
        "description": "Returns a list of normalized custodian reported securities enriched with Intrinio Market data for a provided `reported_date`\n\n**Example Records**\n\nBelow is an example of two security records reported by Schwab, the first is a standard `AAPL` stock and below that\nis an AAPL option. Option records will have additional data points populated that provided specific information about\nthe option as reported by the custodian.\n\n```json\n[\n  {\n    \"reported_date\": \"2024-07-10\",\n    \"source\": \"SWB\",\n    \"cusip\": \"037833100\",\n    \"symbol\": \"AAPL\",\n    \"description\": \"APPLE INC \",\n    \"security_type\": \"COM\",\n    \"security_type_description\": \"COMMON STOCK\",\n    \"option_root_symbol\": \"\",\n    \"option_expiration_date\": \"\",\n    \"option_code\": \"\",\n    \"strike_price_amount\": 0,\n    \"market_data\": {\n        \"symbol\": \"AAPL\",\n        \"description\": \"Apple Inc\",\n        \"figi\": \"BBG000B9Y5X2\",\n        \"composite_figi\": \"BBG000B9XRY4\",\n        \"security_type\": \"Ordinary Shares\",\n        \"security_code\": \"EQS\",\n        \"security_code_description\": \"Equity Shares\"\n    }\n  },\n  {\n    \"reported_date\": \"2024-07-10\",\n    \"source\": \"SWB\",\n    \"cusip\": \"\",\n    \"symbol\": \"AAPL\",\n    \"description\": \"CALL APPLE INC $195        EXP 09/19/25\",\n    \"security_type\": \"OEQ\",\n    \"security_type_description\": \"EQUITY OPTION\",\n    \"option_root_symbol\": \"AAPL\",\n    \"option_expiration_date\": \"2025-09-19\",\n    \"option_code\": \"C\",\n    \"strike_price_amount\": 195,\n    \"market_data\": {\n        \"symbol\": \"AAPL\",\n        \"description\": \"Apple Inc\",\n        \"figi\": \"BBG000B9Y5X2\",\n        \"composite_figi\": \"BBG000B9XRY4\",\n        \"security_type\": \"Ordinary Shares\",\n        \"security_code\": \"EQS\",\n        \"security_code_description\": \"Equity Shares\"\n    }\n  }\n]\n```\n",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "reported_date": {
                    "description": "The reported date of custodian provided securities. This field is required.",
                    "type": "string",
                    "format": "date"
                  }
                },
                "required": [
                  "reported_date"
                ]
              }
            }
          }
        },
        "operationId": "getSecuritiesReference",
        "responses": {
          "200": {
            "description": "List of Security Reference objects",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "reported_date": {
                        "description": "The date the custodian reported the security record.",
                        "type": "string",
                        "format": "date"
                      },
                      "source": {
                        "description": "The custodian code that reported the security.",
                        "type": "string",
                        "enum": [
                          "ALT",
                          "APX",
                          "AXO",
                          "DST",
                          "EGB",
                          "FPR",
                          "IBK",
                          "MLT",
                          "NFS",
                          "PER",
                          "PTA",
                          "SEI",
                          "SWB",
                          "TIA",
                          "WFO"
                        ]
                      },
                      "cusip": {
                        "description": "A unique nine-character code for the security reported by the custodian.",
                        "type": "string"
                      },
                      "symbol": {
                        "description": "The symbol used to represent the Security reported by the custodian.",
                        "type": "string"
                      },
                      "description": {
                        "description": "The description of the Security as reported by the custodian.",
                        "type": "string"
                      },
                      "security_type": {
                        "description": "The security type as reported by the custodian.",
                        "type": "string"
                      },
                      "security_type_description": {
                        "description": "A human readable description of the security_type that was provided by the custodian.",
                        "type": "string"
                      },
                      "option_root_symbol": {
                        "description": "Populated only for options, this is the underlying symbol of the traded option as reported by the custodian.",
                        "type": "string"
                      },
                      "option_expiration_date": {
                        "description": "Populated only for options, this is the expiration date of the option as reported by the custodian.",
                        "type": "string"
                      },
                      "option_code": {
                        "description": "Populated only for options, this is the option type as reported by the custodian.",
                        "type": "string"
                      },
                      "strike_price_amount": {
                        "description": "Populated only for options, this is the strike price of the option as reported by the custodian.",
                        "type": "number"
                      },
                      "market_data": {
                        "description": "Intrinio Market Data for the custodian reported security",
                        "type": "object",
                        "properties": {
                          "symbol": {
                            "description": "Symbol as reported by Intrinio Market Data",
                            "type": "string"
                          },
                          "description": {
                            "description": "Security Description provided by Intrinio Market Data",
                            "type": "string"
                          },
                          "figi": {
                            "description": "Figi of the security provided by Intrinio Market Data",
                            "type": "string"
                          },
                          "composite_figi": {
                            "description": "Composite Figi of the security provided by Intrinio Market Data",
                            "type": "string"
                          },
                          "security_type": {
                            "description": "Security Type provided by Intrinio Market Data",
                            "type": "string"
                          },
                          "security_code": {
                            "description": "Security Code provided by Intrinio Market Data",
                            "type": "string"
                          },
                          "security_code_description": {
                            "description": "Enriched description of the Security Code provided by Intrinio Market Data",
                            "type": "string"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/paths/~1jobs~1/get/responses/400"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Error": {
        "type": "object",
        "required": [
          "message"
        ],
        "properties": {
          "message": {
            "type": "string"
          },
          "validation_errors": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    },
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "Bearer"
      }
    }
  },
  "security": [
    {
      "bearerAuth": []
    }
  ]
}
````