Skip to main content

Introduction

The  API Developer Center is about making it faster and easier for developers to find the information they need to build automated compliance solutions that improve risk management and lower regulatory cost using the FINRA API Platform.

The API Developer Center along with the API Console App on FINRA Gateway are the essential components neccessary for discovering, learning, and using the API Platform.

If you have any questions or difficulty getting started, reach out to the API team.

Getting Started

To get started with FINRA's API Platform first familiarize yourself with the content published here on the API Developer Center. FINRA's API platform is a sophisticated REST based solution with advanced querying capabilities. Becoming familiar with its features will help you build a proper connection to the platform.

Once familiar with the features of the platform, the next step will be to complete any preliminatry steps that your organization may need to complete in order to onboard to the API Platform and get access to the API Console hosted on FINRA Gateway.

The API Console provides self-service API Credential provisioning and management features for API Developers. 


Please contact the API team with any questions on getting started.

Terms of Service

Info for the Firm SAA

The Super Account Administrator (SAA) for your firm is responsible for manging the accounts at your organization that require access to the FINRA API Console.

The API Console is a FINRA Gateway hosted app that allows appropriate indivdiuals in your firm, authorized by the SAA or a designated Account Administrator (AA), to provision API Credentials for use with the FINRA API platform.

Provisioned API Credentials will be displayed in the Account Adminstration App in FINRA Gateway (labeled as Machine to Machine) and will be part of the annual FINRA entitement account certification process, but can only be managed (create, update, delete) via the API Console.

The first step in providing authorized users with access to the FINRA API Console is to request that the FINRA Entitlement Team assign the API Console Entitlement to the SAA's FINRA Entitlement Admin Account. This step is required because as an extra level of security, FINRA has not automatically assigned the API Console Entitlement to SAA Admin Accounts.

To request acccess to this entitlement  the firm SAA must complete and submit an API Console Entitlement Request.This request will be processed by the FINRA Entitlement Team within 3 business days and the SAA will receive an email indicating that the API Console entitlement has been assigned to the SAA's Admin account. Please note that the API Console entitlement is assigned to the SAA's Admin account by default. The SAA may then delegate the entitlement by assigning it to an authorized account administrator (AA).

Once the SAA has been notified that the API Console Entitlement Request has been completed,  the API Console entitlement can be added to appropriate User Accounts at your firm. That API User will then have access to the API Console app on FINRA Gateway and can create API Credentials on behalf of the firm. The API Console entitlement is the only entitlement required to access the API Console. Optionally, the SAA/AA may wish to entittle the API User's account with the E-Bill Invoices entitlement if the user is authorized/responsible for reviewing/paying invoices for any fees associated with the FINRA API Service.

Here are some important considerations when entitiling user accounts with access to the FINRA API Console app:

  • Only users that have the authority to bind the organization to the FINRA API Terms of Service and the payment of any fees associated with the use of the FINRA API Service should be granted access to the API Console app.
  • All fees associated with the use of the API Service will be invoiced through E-Bill, thus it may be appropriate to add the E-Bill Invoices entitlement to an API User account.

Please reach out to the API team if you have any questions regarding the API Console entitlement process. 

Info for Other Organizations

Organization's within the financial services industry, that are not regulated by FINRA, can still access the FINRA API platform by following the steps outlined here.

The first step is to determine if your organization has a previous relationship with FINRA, defined as having a signed FINRA Entitlement Agreement (FEA) in place. Your organization will also have an Organization ID provided by FINRA and a designated Account Certification Representative(CRep) who is also an Account Administrator(AA) -- CRep(AA) -- for your organization.

If you are unable to determine if you organization has a FINRA Entitlement Agreement in place, contact the FINRA Gateway Call Center at (301) 869-6699.

If your organization does not have a previous relationship with FINRA, then step one is requesting onboarding to the FINRA Entitlement Program for the API Platform.

To request onboarding an officer of your organization should complete and submit a FINRA Entitlement Account Administrator request.This request will be processed by the FINRA Entitlement Team within 3 business days and the individual designated as the Account Administrator (AA) and Certification Representative (CRep) -- CRep(AA) -- will receive an email when their FINRA Entitlement Admin Account has been created. Please visit FINRA.org for more information about the FINRA Entitlement Program and the FINRA Account Management System.

Once the CRep(AA) has been notified that the FINRA Entitlement Account Administrator request has been completed, the  API Console entitlement can be added to appropriate User Accounts at your organization (see the Account Management User's Guide). That user will then have access to the API Console app on FINRA Gateway and can create API Accounts on behalf of the organization. The API Console entitlement is the only entitlement required to access the API Console. Optionally, the CRep(AA) may wish to entitle the API User's account with the E-Bill Invoices entitlement if the user is authorized/responsible for reviewing/paying invoices for any fees associated with the FINRA API Service.

Here are some important considerations when entitling users with access to the FINRA API Console app:

  • Only users that have the authority to bind your organization to the FINRA API Terms of Service and the payment of any fees associated with the use of the API Service should be granted access to the API Console app.
  • All fees associated with the use of the API Service will be invoiced through through FINRA's E-Bill app on FINRA Gateway, thus it may be appropriate to add the E-Bill Invoices entitlement to an API User account.

Please reach out to the API team if you have any questions regarding the API Console entitlement process. 

If your organization has a previous relationship with FINRA, defined as having a signed FINRA Entitlement Agreement (FEA) in place and a designated Certification Representative (CRep) who is also an Account Administrator (AA) -- CRep(AA) --, then that CRep(AA) should request  that the FINRA Entitlement Team assign the API Console Entitlement to their FINRA Entitlement Admin Account. This step is required because as an extra level of security, FINRA has not automatically assigned the API Console Entitlement to AA Admin Accounts.

To request access to this entitlement the CRep(AA) of your organization should complete and submit an API Console Entitlement Request.This request will be processed by the FINRA Entitlement Team within 3 business days and the CRep(AA) will receive an email indicating that the API Console entitlement has been assigned to their Admin account. Please note that the API Console entitlement is assigned to the CRep(AA) who filled out the form by default. The CRep(AA) may then delegate the entitlement by assigning it to another authorized account administrator(AA).

Once the CRep(AA) has been notified that the API Console Entitlement request has been completed, the  API Console entitlement can be added to appropriate User Accounts at your organization (see the Account Management User's Guide). That user will then have access to the API Console app on FINRA Gateway and can create API Accounts on behalf of the organization. The API Console entitlement is the only entitlement required to access the API Console. Optionally, the CRep(AA) may wish to entitle the API User's account with the E-Bill Invoices entitlement if the user is authorized/responsible for reviewing/paying invoices for any fees associated with the FINRA API Service.

Here are some important considerations when entitling users with access to the FINRA API Console app:

  • Only users that have the authority to bind your organization to the FINRA API Terms of Service and the payment of any fees associated with the use of the API Service should be granted access to the API Console app.
  • All fees associated with the use of the API Service will be invoiced through FINRA's E-Bill app on FINRA Gateway, thus it may be appropriate to add the E-Bill Invoices entitlement to an API User account.

Please reach out to the API team if you have any questions regarding the API Console entitlement process. 

The API Console

The API Console is a FINRA Gateway hosted app that provides a fully automated, self-service API credential management capability to FINRA’s API customers.

The process for accessing the API Console depends on whether you are affililated with an organization regulated by FINRA, affiliated with an another organization not regulated by FINRA (e.g. vendor, service provider, insurance company), or an individual just interested in learning about the API Platform and testing it out, or using the platform for your own non-commercial purpose.

The sections below describe the two key concepts necessary for understanding how access to the API platform is determined(API User Types and API Credential Types), and provide detailed instructions for getting started with the API console depending on your role and purpose.

Please feel free to contact the API Team with any questions regarding the API Console or for a demonstration of its capabilities.

API User Types

You are a Firm User if you are affiliated with an organization regulated by FINRA such as broker-dealer or a dually registered broker-dealer/investment advisor.

You will obtain access to the FINRA API Console via your firm's designated Super Account Administrator (SAA) or an Account Administrator (AA).

If your firm is new to the API platform, the firm's SAA will first need to request that the API Console entitlement is assigned to the SAA's FINRA Entitlement Admin Account. Please direct the SAA to this page for specific details on getting access to the API Console Entitlement from the FINRA Entitlement team.

Once the SAA's Admin Account is assigned the API Console entitlement, the SAA will authorize your access to the API Console by either creating a FINRA Gateway User Account for you with the API Console entitlement, or by adding the API Console entitlement to your existing FINRA Gateway User Account.

If you have responsibility for reviewing/paying invoices associated with the FINRA API Platform via via FINRA's E-Bill application (also accessed via FINRA Gateway), the SAA will also have to add the E-Bill Invoices entitlement to your account. Please discuss this need with your SAA.

Once your account is created/update you can login to the console by selecting the Console button in the navigation bar. This will redirect you directly to the API Console app in FINRA Gateway.

As a Firm user you will be able to provision three types of API Credentials:

  • Firm Credential
  • Public Credential
  • Test Credential

See the API Fee Page for more details on the capabilities provided by each type of credential.

You may wish to create an Individual API User Account to begin testing and learning about the API Platform, before requesting access to the API Console via your firm SAA. This is possible by following the instructions for the Individual User Type below and is a good way to get started quickly. However, a Firm Credential is the only way to get access to data associated with your specific firm, such as registration data, and the Individual Account only allows provisioning of Public and Test Credentials.

 

TIPS:

  • If you do not know who the SAA is for your firm, contact the FINRA Gateway Call Center at (301) 869-6699.
  • If you create an Individual API User Account to get started, you will still need to request a Firm User Account from your SAA to access Firm information and other datasets. An Indivdiual Account cannot be upgraded to a Firm Account.

The Organization Credential type is available to other organizations not regulated by FINRA, including product manufacturers (example insurance companies, mutual fund organizations), transfer agents, clearing firms, vendors and service providers. 

You will obtain access to the FINRA API Console via your organizations's designated Account Administrator (AA).

If your organization does not have a previous relationship with FINRA, then step one is to have an officer of your organization request onboarding to the FINRA Entitlement Program for the API Platform.

A previous relationship with FINRA is defined as having a signed FINRA Entitlement Agreement in place. Your organization will also have an Organization ID provided by FINRA and a designated Account Certification Representative(CRep) who is also an Account Administrator(AA) for your organization. Please direct an officer to this page for specific details on requesting onboarding which includes designating an individual to be an AA and CRep -- CRep(AA) -- for your organization.

If your organization has a FINRA Entitlement Agreement in place but is new to the API platform, then the CRep(AA) will first need to request that the API Console entitlement be assigned to their FINRA Entitlement Admin Account. Please direct the CRep(AA) to this page for specific details on getting access to the API Console Entitlement from the FINRA Entitlement team.

Once the CRep(AA) Admin Account is assigned the API Console entitlement, the CRep(AA) will authorize user access to the API Console by either creating a FINRA Gateway User Account for you with the API Console entitlement, or by adding the API Console entitlement to your existing FINRA Gateway User Account.

If you have responsibility for reviewing/paying invoices associated with the FINRA API Platform via FINRA's E-Bill application (also accessed via FINRA Gateway), the CRep(AA) will also have to add the E-Bill Invoices entitlement to your account. Please discuss this need with your CRep(AA).

Once your account is created/update you can login to the console by selecting the Console button in the navigation bar. This will redirect you directly to the API Console app in FINRA Gateway.

As an Organization User you will be able to provision three types of API Credentials:

  • Organization Credential
  • Public Credential
  • Test Credential

See the API Fee Page for more details on the access provided by each type of credential.

You may wish to create an Individual API User Account to begin testing and learning about the API Platform, before requesting access to the API Console via your organization CRep(AA). This is possible by following the instructions for the Individual User Type below and is a good way to get started quickly. However,  the Individual Account only allows provisioning of Public and Test Credentials, and an Organization Credential will be required to access the capabilities associated with the Organization Credential Type.

 

TIPS:

  • If you do not know if your organization has a FINRA Entitlement Agreement in place, or who the CRep(AA) is for your organization, contact the FINRA Gateway Call Center at (301) 869-6699.
  • If you create an Individual API User Account to get started, you will still need to request an Organization User Account from your CRep(AA) to access the capabilities associated with an Organization Credential Type. An Individual Account cannot be upgraded to an Organization Account.

You are an Individual User if you plan to access the API Platform for your own purpose, regardless of your affiliation with a firm or other organization.

You will obtain access to the API Console by creating an Individual API User Account by selecting the Console button in the Navigation Bar and then selecting the Create Account Here link on the FINRA login page.

You will receive the credentials for your Individual User Account via email including a password reset link.

NOTES:

  1. Check your SPAM filter or JUNK MAIL folders for the credential email
  2. The password reset link expires in 1 hour so prompt action is required. If the link expires you must contact the FINRA Gateway Call Center at (301) 869-6699 to have another password reset link sent to your email address.
  3. The account password expires and will have to be changed every 120 days. Obtain a new password here.

Once your account is created you will be redirected directly to the API Console app in FINRA Gateway. 

As an Individual User you will be able to provision two types of API Credentials:

  • Public Credential
  • Test Credential

Individual Accounts are intended for developers who want to begin exploring and testing the API Platform before committing to an integration effort, and for individual investors, researchers, etc. that need access to public data provided by FINRA via the API Platform. It is not intended for commercial purposes at this time.

Important Information for Users Who Have Previously Created Test Credentials

Existing API Users who have created Test Credentials via the "Request Test Access" button on developer.finra.org (no longer available) can use those credentials to access the API Console as an Indivdiual User without further action. There is no need to create an additional Individual Account to access the API Console, and the FINRA Login service will not allow multiple Individual Accounts to be tied to the same e-mail address.

Your existing Test Credentials can also continue to be used to access the mock data via API until 3/31/2022. At that time the Test Credential will convert to an Individual Account and can only be used to login to the API Console.

Therefore, once you have access to the API Console using your existing Test Credentials you should provision a new Test Credential via the API Console and use the new credential for your testing purposes. You may also provision a Public Credential to access the available public data via the console.
 

TIP: If you are having difficulty logging in to the API Console using your Test Credential contact, the FINRA Gateway Call Center at (301) 869-6699.

API Credential Types

The Firm Credential Type can be provisioned by Firm Users who have been granted access to the API Console by the firm's SAA or AA.

See the Fee Structure page for details on the capabilities offered by the Firm Credential.

The Organization Credential Type can be provisioned by Organization Users who have been granted access to the API Console by the organization's AA.

See the Fee Structure page for details on the capabilities offered by the Organization Credential.

The Public Credential Type can be provisioned by Firm, Organization, and Individual Users who have access to the API Console.

See the Fee Structure page for details on the capabilities offered by the Public Credential.

The Test Credential Type can be provisioned by Firm, Organization, and Individual Users who have access to the API Console.

Each dataset delivered via the API platform will have test data available. The test data will be a representative sample but may be randomized or mock data. This data can be used by developers to evaluate available APIs and to to test their integrations with the FINRA API platform.

 

See the Dataset Catalog for details on available datasets.

A Test Credential can only be used with mock datasets. This means the dataset name must have "MOCK" appended to the end of the name. (e.g. preRegistrationIndividualMock). 

Public, Firm, and Organization credentials CANNOT access mock datasets.

Creating an API Credential

An API Credential is required to make API requests on the FINRA API platform. It is the equivalent of a username and password for logging into a website or application, but is used in the Authorization header of all API requests to authenticate the API client (AuthZ) with the API platform, and to authorize (AuthN) the API client to access the data and services on the platform.

Each API credential you create will have an API Client ID (created by the API Console) and an API Client Secret (provided by you when activating the API credential as described below). Each API credential is linked to the UserID you used to login to FINRA Gateway and access the API Console app.

Once you have access to the API Console and have logged in to FINRA Gateway, you will see the API Credentials view with an empty My Credentials tab.

api console screenshot

 

To create your first credential select either ADD API CREDENTIAL button to access the API Credential Details form.

api credential details

Complete this form, agree to the FINRA API Terms of Service and select the CREATE button to submit the request.

Once created the new credential will be added to the credential list in the My Credentials tab.

api credential list

Note that the API Secret for the new credential is initially shown as Expired. This is because an API Secret create link is sent to the email address of the API Console user (subject: FINRA API Developer Center – Action Required) and must be used to choose an API Secret and complete the process of activating the API Credential. See the API Credential Creation Tips below for important information about activating the API Credential.

When you have received the activation email select the Create API Client Secret button in the message to be taken to the FINRA Reset Password page.

reset password page

Enter the API Client ID in the User ID text box and provide your chosen password (API Client Secret). Select the SAVE button and the API Credential will now be activated.

api credential list
 

Congratulations you have created your first API Credential for use with the FINRA API Platform. Now review these details to put the new credential to work.

IMPORTANT: API Credential Creation Tips
  1. The API Credential name is an alias that your provide to help you remember your use intention for the credential. It can be changed in the API Console at any time (feature coming soon).
  2. The Type dropdown allows you to select the type of credential you would like to create. The allowable selections are based on your user type. For example,  if you are logged-in to the API Console as an Individual User, the allowable selections will include test and public.
  3. The Total Fee Per Month will change to reflect any fees associated with a credential type. When you select the SAVE button to create a credential with an associated fee, your organization will be invoiced for that credential on E-Bill.
  4. The API Secret create link sent via email EXPIRES in 24 hours. If the link expires, you will need to contact the API Support team to have another create link sent via email (a client secret reset feature is coming soon).
  5. You will also receive the API Client Id in a seprate email (subject: FINRA API Developer Center – Important Information). You will need the API Client Id when activating the API credential.
  6. Look in your Junk Mail/Spam Filters for the FINRA API email messages if you do not receive them within a few minutes. If you do not receive the email messages within an hour contact the API Support team to let us know.
  7. When activating the API Credential and choosing an API Secret note that the User ID you are asked to provide is the Client ID shown in the My Credentials tab for the API Credential you are activating and NOT the User ID you used to login to FINRA Gateway.
  8. Note that the API Secret expires in one year and will need to be reset it via the API Console (feature coming soon).

API Platform Basics

The sections below provide an overview of the basic features of the FINRA API Platform.

Authorization

The FINRA API Platform authentication and authorization scheme is based on OAuth 2.0.

OAuth 2.0 enhances security by replacing the use of long-lasting credentials with limited life span tokens, reducing the potential of exposing an API Credential.

The overall authentication flow is:

  1. API client sends a  POST request to the FINRA Identify Platform (FIP) using the API Client ID and API Client Secret associated with an API credential (created via the API Console) as a Basic Auth token in the Authorization Header.
  2. Use "access_token" returned from FIP as a Bearer token in the Authorization Header to invoke the required FINRA API endpoint(s).
  3. Use "expires_in", returned from FIP as the number of seconds until expiry, to determine the expiration time of the "access_token" and regenerate the access_token via another FIP request before this time, or cache the access_token for 30 minutes before regenerating.

OAuth 2.0 Flow

 NOTES:

  • The FIP endpoint for generating an access_token is: https://ews.fip.finra.org/fip/rest/ews/oauth2/access_token?grant_type=client_credentials.
  • API Client must use a POST request
  • The Basic Authorization header sent to the FIP access_token endpoint contains the word Basic followed by a space and a base64-encoded string containing "apiclientid:apiclientsecret".  Note that the colon ":" is required in the token string before it is base64 encoded.
  • The API Client ID and API Client Secret are provisioned through the API Console.
  • The access_token returned by FIP is used as a BEARER token in the Authorization header (Bearer access_token) of API requests and not a Basic Auth token.
     
Request
curl --location --request POST 'https://ews.fip.finra.org/fip/rest/ews/oauth2/access_token?grant_type=client_credentials
--header 'Authorization: Basic VXNlcjpwYXNzd29yZA=='

 

Response
{
    "access_token": "*AAJTSQACMDIABHR5cGUAA0pXVAACUzEAAjAx*eyJ0eXAiOiJKV1QiLCJjdHkiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.ZXlKMGVYQWlPaU pLVjFRaUxDSmxibU1pT2lKQk1USTRRMEpETFVoVE1qVTJJaXdpWVd4bklqb2laR2x5SW4wLi56RlNXS09XZklKX1FJT3htWEZtalpB LjF4LVVCMF9OdG85WmhkZlRvTW10dXNNZkxGMUN6MS0tVVVKYTYzYXBwdm8xWExVYzRLXy1raUVEOHFpRXpLZU14aUtLWDc1eTRwcVc4eVlDMs",
    "scope": "any",
    "token_type": "Bearer",
    "expires_in":"43170"
}

 

Important:

The use of Basic Auth for FINRA API requests is being deprecated on 5/31/2022. Current API customers utilizing Basic Auth for API authorization should plan for migrating to OAuth 2.0 on or before 5/31/2022.

 

Both Basic Auth and OAuth 2.0 can be used in parrallel until 5/31/2022.

Request Headers

The API platform supports the following headers in all API requests:

header required description default
Authorization required Contains the word Bearer followed by a space and an access_token generated from the FINRA Identity Platform (FIP) n/a
Accept optional

Can be used to specify a format for the data returned. Supports (application/json and text/plain). If the native data format cannot convert between JSON/CSV, then a status code of 400 will be returned. If an unsupported MIME type is supplied, then a 406 is returned.

text/plain
Data-API-Version optional Used to specify version of the API to use. version 1

Response Headers

All responses to API requests may include the following response headers:

header description
Content-Type Set to match the value of the request's Accept header unless an error occurred, in which case it will be set to application/json. Possible values include application/json and text/plain.
Record-Total Total records found at the time of the request. Use this value when paging through large datasets to determine when all data has been retrieved.
Record-Offset Set to match the offset value provided with the request.
Record-Limit Set to match the limit value provided with the request or the platform maximum limit, whichever is smaller. 
Record-Max-Limit  Set to the maximum number of records that will be returned by the platform, regardless of the size of the response payload. Use this header to build an API client that can adapt to future record limit value changes.
Response-Payload-Max-Size  Set to the maximum payload size (in MB) that will be returned by the platform, regardless of the number of records returned. Use this header to build an API client that can adapt to future response payload size changes.
Location Contains a URL that will be used as the second leg of the operation to check the status of the asynchronous request.

Platform Usage Limits

FINRA reserves the right to limit the number of requests made by an API Client, the number of records returned in a response or the size of a response payload, as well as other parameters as necessary to ensure the reliability, performance, and integrity of the API platform.

The API platform enforces the following throttling limits:

  1. Sychronous requests:   20 requests per second per IP address
  2. Asynchronous requests: 20 requests per hour per dataset per API account

Maintaining a reliable, performant API platform is a joint responsibility of the FINRA API team and all API users. Adhering to the following guidelines will help ensure the integrity of the platform:

  1. Only access as much data as needed to accomplish your objective or use case. Use compare filters and the other POST filter parameters to reduce the amount of data returned in a response whenever possible.
  2. Utilize a GET request only when trying to sample a small number of records using the limit parameter. Otherwise, the POST request should be used in order to filter the data on each request. NOTE: This guideline does not apply when using asynchronous requests and polling for the async result or accessing the async response file, which should utilize GET requests.
  3. Understand the data you are trying to access. In many cases, the data is static after a period of time and there is no need to repeatedly download historical data. For example, most of the data available via the Equity API is generally static after one year. Therefore adjust your access patterns to avoid downloading historical data over one year old on a recurring basis.
  4. Develop sound algorithms that access available data in smaller traunches rather than simply accessing as many records as possible on each requests. Each dataset offers a number of fields that can be used in filters such as trade dates, week and month start dates, tier levels, CRD numbers, etc.
  5. Utilize asynchronous requests whenever accessing a large number of records as this will allow you to obtain more records per API request while helping to protect the platform.
  6. Utilize asynchronous requests in combination with the available historical datasets (e.g. weeklySummaryHistorical).
  7. Brute force algorithms that simply run 24*7*365 and continuously access the same data are never appropriate and are subject to being blocked.

The API platform enforces two limits regarding the maximum amount of data returned by an API request:

  • Maximum Record Limit: the maximum number of records returned by an API request. 
  • Maximum Payload Size: the maximum payload size returned in the response payload.
  • Whichever limit is reached first will govern the amount of data returned. 

 The API platform limits the number of records that can be returned from a individual API request:

  1. Synchronous requests will return a maximum of 5000 records for any one API request
  2. Asynchronous requests will return a maximum or 100,000 records for any one API request.

NOTE : The API record limit defaults to 1000 unless a larger number is specified using the limit query string (GET) or request parameter (POST).

The API platform limits the amount of data that can be returned in the body of an individual API request:

  1. Synchronous requests will return a maximum of 3MB of data in the response body of any one API request.
  2. Asynchronous requests can return any amount of data and are not limited to the 3MB response body size.

When working with large datasets that contain more records than the maximum record limits (5,000 synchronous /100,000 asynchronous) the API user must design an algorithm to access the data in traunches that honor the platform usage limits.

The key request parameters that faciliate accessing data in traunches include:

  • Limit parameter: Number of records to return. The default value (if limit parameter is not provided on a request) is 1000. 
  • Offset parameter: Record number to start with (exclusive). For example, if the offset is 0 and the limit is 20, then records 1 to 20 are returned for a total of 20 records. If the offset is 10 and the limit is 10, then records 11 to 20 are returned.

IMPORTANT:

The offset parameter has a maximum value of 500,000. The effect of this limit is that a maximum of 505,000 records can be accessed synchronously, and a maximum of 600,000 records can be accessed asynchronously, without the use of additional filters. For example, the weeklySummary dataset contains more than 20 million records. Because of the 500,000 offset limit it is not possible to access all 20M+ records simply by increasing the offset parameter until all data is accessed.

Instead the API user would need to utilize filters in conjunction with the limit and offset parameters to access the entire range of records in the dataset. In the case of the weeklySummary dataset, for example, the API user might filter the dataset by the weekStartDate and tierIdentifier fields to reduce the overall size of the data and then page through that traunch of data using the limit and offset parameters as needed. The data access algorithm can then step through the available weekStartDate and tierIdentifier values to access the entire dataset in a manner consistent with the platform usage limits.

There are a number of  response headers that can be used to page through larger datasets in compliance with the response size and offset limits, including:

  • Record-Total response header: Total records found at the time of the request. Use this value when paging through large datasets to determine when all data has been retrieved.
  • Record-Offset response header: Set to match the offset value provided with the request.
  • Record-Limit response header: Set to match the limit value provided with the request or the platform maximum limit, whichever is smaller. 
  • Record-Max-Limit response header: Returns the current maximum number of records that will be returned by the API platform. Use to build a flexible integration that can adapt to future record limit changes.
  • Response-Payload_Max_Size response header: Returns the current maximum payload size (in MB) returned by the API platform. Use to build a flexible integration that can adapt to future payload response size changes. Applies only to synchronous API requests.

Notes:

  1. To maximize the number of records returned in a response minimize the number of fields you return and use the text/plain Accept header on  your requests whenever possible (e.g. the Equity datasets support text/plain).
  2. API clients should count the number of records returned in each response in order to ensure all expected data is returned, and to adapt future requests if less data than expected was returned because the record and/or the response payload size limits are reached.

Time Zones

All date and time related fields in the API requests are interpreted as Eastern Standard Time. Date/time fields returned in an API response are returned in the same time zone as the raw data when initially stored. No time zone conversion is performed.

Troubleshooting

The following API response codes are returned by the Data API platform:

HTTP status code Reason
200 OK
201 Created
204 No Content
400 Bad Request
410 Unauthorized
403 Forbidden
404 Not Found
405 Method Not Allowed
406 Not Acceptable
409 Conflict
415 Unsupported Media Type
500  Internal Server Error
502 Bad Gateway
503 Service Unavailable
504 Gateway Timeout


The 200 status code is returned for successful requests even when the request returns no data. For requests receiving application/json output the response body will contain any empty JSON array. For requests receiving text/plain output the response body will contain the header row with no data rows.

The 4xx status codes are returned when a problem exists with a request. The response body will contain a JSON structure with additional information about the error.

5xx status codes are returned when there is a service level error that cannot be identified. The API support team is notified of all error conditions therefore it is not necessary to report these errors via the Support Center, unless the error persists for an extended period of time.

{
"statusCode": 400,
"statusDescription": "Bad Request",
"requestId": "ba7c841a-5322-4e07-863a-a44f09a5fc59",
"message": "Invalid date field format. Must be yyyy-MM-dd or yyyy-MM-dd HH:mm:ss.SSS",
"dataRequest": {
"action": "POST",
"internalParams": {},
"datasetGroup": "OTCMarket",
"datasetName": "weeklySummary",
"fields": [],
"dateRangeFilters": [
{
"description": "Filter used to specify a date time range of format (yyyy-MM-dd | yyyy-MM-dd HH:mm:ss(.SSS)). For example, 2017-02-10 21:30:23. Start and End dates are inclusive.",
"startDate": "2017-01-01",
"endDate": "2399-12-31",
"fieldName": "weekStartDate"
}
],
"domainFilters": [],
"compareFilters": [
{
"description": "Filter used to compare field values using traditional equal, not equal, gt, lt, gte, or lte logic.",
"fieldName": "tierIdentifier",
"fieldValue": "T2",
"compareType": "EQUAL"
},
{
"description": "Filter used to compare field values using traditional equal, not equal, gt, lt, gte, or lte logic.",
"fieldName": "weekStartDate",
"fieldValue": "201-03-11",
"compareType": "EQUAL"
},
{
"description": "Filter used to compare field values using traditional equal, not equal, gt, lt, gte, or lte logic.",
"fieldName": "summaryTypeCode",
"fieldValue": "ATS_W_SMBL",
"compareType": "EQUAL"
},
{
"description": "Filter used to compare field values using traditional equal, not equal, gt, lt, gte, or lte logic.",
"fieldName": "issueSymbolIdentifier",
"fieldValue": "ELAN.V",
"compareType": "EQUAL"
}
],
"sortFields": [
"issueSymbolIdentifier",
"marketParticipantName"
],
"limit": 1000,
"offset": 0,
"delimiter": ",",
"quoteValues": true,
"format": "text/plain"
}
}

 

Service Availability

The API platform service availability timeframe is 8am-8pm weekdays. All scheduled maintenance is done outside the service availability window. 

Base URL

The base resource URL for the FINRA API Platform is: https://api.finra.org.

Important:

All API requests must use HTTPS protocol.

Query API

API Basics

Datasets

The API platform utilizes datasets as part of the Query API to deliver a variety of data via the /data endpoint. All datasets are associated with a dataset group and have a dataset name. The  /data endpoint utilizes one of the following structures:

/data/group/{group name}/name/{dataset name}

or

/data/group/{group name}/name/{dataset name}/id/{id}

Each dataset has a test version associated with it as well as the production version. The test dataset appends the word "MOCK" to the end of the production dataset name to signify that the data returned is mock or test data and not production data.

You can explore documentation for available datasets in each category of Query API from the navigation menu on the left.

Single Record Datasets

Single record datasets return a single record based on the user specified primary id field and follow the /data/group/{group name}/name/{dataset name}/id/{id} structure.

The metadata for the dataset will identify a Primary ID if the dataset supports the single record structure.

An example of a single record dataset is the Registration Validation dataset.

Historical Datasets

In addition to the production and mock dataset versions, a dataset may also have a historical version.

Historical datasets contain data that is typically more than a year old and facilitate access to a large span of prior period data. Historical datasets are identified by appending "HISTORIC" to the end of the production dataset name. Utilize the historical datasets to access previous period data and the production dataset for current period data (generally the last rolling twelve months of data).

Historical datasets provide limited filtering capability:

  • Only specific fields in the dataset can be used in a compareFilter.
  • The compareType must be EQUAL
  • Only one time based field can be filtered (e.g. date field).

In addition, historical datasets do not support sorting.

Explore the filtering details for each specific historical dataset by selecting the dataset links in the navigation menu on the left. Or use the /metadata endpoint to see more information about available filtering options for specific historical datasets.

API Request Types

The API platform supports both synchronous and asynchronous requests.

The request type is specified using the "async" query parameter on GET requests: api.finra.org/{resource path}?async=true and as a request parameter on POST requests: "async" : true. 

The async parameter defaults to false if not provided, which indicates a synchronous request.

Synchronous requests (async=false) are RESTful API requests that return a status code and a response body. Once the response body is received, the synchronous operation is complete. A status code of 200 indicates a successful request.

Synchronous requests are best used when the API client is filtering a large dataset to return a limited dataset, or when downloading data within a small time period such as a day. If a synchronous request times out, an asynchronous request should be used.

Aynchronous requests (async=true) behave differently in that they are a three-legged operation. The first leg of the operation is identical to the request that is made using the synchronous request type except the async  parameter is set to true.

The response to this request includes a status code but DOES NOT include the response body. Instead the response includes a Location header that contains a URL that will be used as the second leg of the operation to check the status of the asynchronous request. Note that the status code will be set to 202 when the initial async request is successful and the Location header has been set to the status URL.

The format of the URL in the Location header is: api.finra.org/async-requests/{resource path}/{request id}.

The API client should invoke the status URL on a recurring basis (polling) until a status code of 200 is received. Note that this request requies a Bearer Token. A status code of 202 will be returned if the asynchronous request is still pending. The recommendation is to poll using the status URL no more than once per minute until a status code of 200 is received.

The response body of the status request will contain the request id parameter (requestId) of the asynchronous operation and a status parameter (status). The status will be set to pending when the status code returned is 202. It will be set to complete when the status code returned is 200.

The response body also contains two additional parameters when the status is complete. The resultLink parameter contains a pre-signed AWS S3 URL that points to the request results (the dataset). The expires parameter will contain an ISSO 9001 UTC time code indicating when the pre-signed resultLink will expire. The API client must invoke the pre-signed URL to obtain the dataset result prior to it expiring, or must restart the asynchronous operation from the beginning. The result will expire 2 hours after a status code of 200 is received from invoking the status URL or 24 hours after the result dataset is created,  whichever is earlier

Important

Do not provide an authorization header when accessing the resultLink URL as it includes an embeded authorization token as a query parameter and the request will return a 400 status code if an authorization header is provided.

Asynchronous Request Example

  Action Request Response
1

Submit Async Request

GET: api.finra.org/data/group/firm/name/registeredindividual?async=true

POST: api.finra.org/data/group/firm/name/registeredindividual

{
  "async":true, 

   "limit":100000,

  "offset":200000,
}

StatusCode: 202

Response header "Location" has the status link. 

The response payload is empty.

2 Check status of request

GET:  api.finra.org/async-requests/group/firm/name/registeredindividual/0ba2c6e6-c13b-4a47-989a- c47106ab98ce

StatusCode: 202

{
   "requestId": "0ba2c6e6-c13b-4a47-989a-c47106ab98ce",
   "status": "pending"
}

3 Check status of request

GET: api.finra.org/async-requests/group/firm/name/registeredindividual/0ba2c6e6-c13b-4a47-989a-c47106ab98ce

StatusCode: 200

{
   "requestId": "0ba2c6e6-c13b-4a47-989a-c47106ab98ce",
   "expires": "2020-06-26 19:05:38 UTC",
   "resultLink": {pre-signed S3 URL}
   "status": "complete"

Additional Considerations

Platform Usage Limits apply for both synchronous and asynchronous requests. Please review this information in order to design an API integration that is performant and that protects the overall integrity of the API platform.

The response from both synchronous and asynchronous requests include Response Headers that are important when dealing with the platform usage limits. Note that the reponse headers are only included for asynchronous requests when the status is complete (status code 200).

Sorting Restrictions

Due to the performance implications of API users trying to sort large datasets (some of which contain tens of millions of records) utilizing the FINRA API platform, the use of the sortFields request parameter is restricted.

The use of the sortFields parameter requires that the API request also includes a compareFilter with a compareType of EQUAL on any partition fields associated with the dataset. For example:

1. The weeklySummary dataset contains the weekStartDate and tierIdentifier partition fields. A compareFilter with compareType EQUAL is required for both of these fields when including the sortFields parameter in an API request.

2. The blocksSummary dataset contains the monthStartDate partition field. A compareFilter with compareType EQUAL is required for this field when including the sortFields parameter in an API request.

If the request does not contain the required partition field compare filters, an error response will be returned.

You can use the metadata endpoint to identify the partition fields for each dataset, and the partitions endpoint provides the available values for a partiion field.

NOTES:

  1. If a dataset does not have partition fields (e.g. the Registration API datasets) then a compareFilter for the partition field(s) is not required.
  2. Sorting is not supported on historical datasets (.e.g weeklySummaryHistoric).

Resource Endpoints

GET Metadata

Returns the dataset metadata including which fields are available, the data type of the field, and a description. Use this endpoint to discover what fields are available in a dataset.

GET /metadata/group/{group name}/name/{dataset name}

None.

header required description default
Authorization optional

Contains the word Basic followed by a space and a base64-encoded string of ther form "clientid:clientSecret"

n/a
Data-API-Version optional Used to specify version of the API to use. Version 1

 

 

Request
https://api.finra.org/metadata/group/otcmarket/name/weeklysummary

 

Response
{
    "datasetGroup": "OTCMARKET",
    "datasetName": "WEEKLYSUMMARY",
    "partitionFields": [
        "weekStartDate",
        "tierIdentifier"
    ],
    "fields": [
        {
            "name": "issueSymbolIdentifier",
            "type": "String",
            "description": "Assigned by the NASDAQ listing market and ACT Symbol for Other Exchange Listed (NMS stocks), or by FINRA (OTCE securities). Suffix is separated from root symbol with a special character"
        },
        {
            "name": "issueName",
            "type": "String",
            "description": "Company name associated with the Symbol"
        },
        {
            "name": "firmCRDNumber",
            "type": "Number",
            "description": "Firm CRD Number"
        },
        {
            "name": "MPID",
            "type": "String",
            "description": "ATS/OTC identifier"
        },
        {
            "name": "marketParticipantName",
            "type": "String",
            "description": "Company name of the ATS/OTC or or De Minimis Firm"
        },
        {
            "name": "tierIdentifier",
            "type": "String",
            "description": "T1 - Securities included in the S&P 500, Russell 1000 and selected exchange-traded products; T2 - All other NMS stocks; OTC - Over-the-Counter equity securities"
        },
        {
            "name": "tierDescription",
            "type": "String",
            "description": "NMS Tier 1 - Securities included in the S&P 500, Russell 1000 and selected exchange-traded products; NMS Tier 2 - All other NMS stocks; OTCE - Over-the-Counter equity securities"
        },
        {
            "name": "summaryStartDate",
            "type": "Date",
            "format": "yyyy-MM-dd",
            "description": "Report Start Date (Monday)"
        },
        {
            "name": "totalWeeklyTradeCount",
            "type": "Number",
            "description": "Aggregate weekly total number of trades reported by each ATS for the Symbol"
        },
        {
            "name": "totalWeeklyShareQuantity",
            "type": "Number",
            "description": "Aggregate weekly total number of shares reported by each ATS for the Symbol"
        },
        {
            "name": "productTypeCode",
            "type": "String",
            "description": "Product Type"
        },
        {
            "name": "summaryTypeCode",
            "type": "String",
            "description": "Report Type Identifier ( OTC_ W_FIRM: OTC Weekly Firm, OTC_ W_SMBL: OTC Weekly Symbol, OTC_ W_SMBL_FIRM: OTC Weekly Symbol Firm, OTC_ W_VOL_STATS: OTC Volume Statistics, ATS_ W_Firm: ATS Weekly Firm, ATS_ W_SMBL: ATS Weekly Symbol, ATS_ W_SMBL_FIRM: ATS Weekly Symbol Firm, ATS_ W_VOL_STATS: ATS Volume Statistics)"
        },
        {
            "name": "weekStartDate",
            "type": "Date",
            "format": "yyyy-MM-dd",
            "description": "Partition Key - the first business day of the week (Monday)"
        },
        {
            "name": "lastUpdateDate",
            "type": "Date",
            "format": "yyyy-MM-dd",
            "description": "Most recent date on which total trades is updated based on data received from each ATS/OTC"
        },
        {
            "name": "initialPublishedDate",
            "type": "Date",
            "format": "yyyy-MM-dd",
            "description": "The initial publish date is the first Monday or next business day after the reporting delay based on NMS Tier 1 (two week delay), NMS Tier 2 (four week delay) and OTC securities (four week delay)"
        },
        {
            "name": "lastReportedDate",
            "type": "Date",
            "format": "yyyy-MM-dd",
            "description": "This date represents the last time a firm sent an update to any underlying data that contributes to the aggregate count"
        }
    ]
}

 

 

GET Partitions

Returns unique values and versions of those values for the partition(s) of a dataset.

GET /partitions/group/{group name}/name/{dataset name}

None.

Request
https://api.finra.org/partitions/group/fixedincomemarket/name/treasuryweeklyaggregates

 

Response
{
    "datasetGroup": "fixedincomemarket",
    "datasetName": "treasuryweeklyaggregates",
    "partitionFields": [
        "beginningOfWeekDate"
    ],
    "availablePartitions": [
        {
            "partitions": [
                "2021-02-15"
            ]
        },
        {
            "partitions": [
                "2021-02-08"
            ]
        },
        {
            "partitions": [
                "2021-02-01"
            ]
        },
        {
            "partitions": [
                "2021-01-25"
            ]
        },
        {
            "partitions": [
                "2021-01-18"
            ]
        },
        {
            "partitions": [
                "2021-01-11"
            ]
        },
        {
            "partitions": [
                "2021-01-04"
            ]
        },
        {
            "partitions": [
                "2020-12-28"
            ]
        },
        {
            "partitions": [
                "2020-12-21"
            ]
        }
    ]
}

 

GET Data

Returns data from specified dataset in deliminated (default) or JSON format depending on the value of the ACCEPT header in the request.

GET /data/group/{group name}/name/{dataset name}

parameter description default
fields Comma delimited list of field names to retrieve all fields are returned
limit

Number of records to return. 

NOTE: See the Platform Usage Limits page for more details.

1000
quotevalues Can be used to specify if values should be quoted if the Accept header is text/plain. true
async The API request type. Set to true to specify an asynchronous request. Set to false to specify an synchronous request. false
sortFields Comma delimited list of field names to sort by. You can prepend a + or - before the field name to specify an ascending or descending sort on that field respectively. See the Sorting Restrictions page for more details. no sorting performed

 

header required description default
Authorization required

Contains the word Basic followed by a space and a base64-encoded string of ther form "clientid:clientSecret"

n/a
Accept optional Can be used to specify a format for the data returned. Supports (application/json, text/plain). If the native data format cannot be converted between JSON/CSV then a status code of 400 will be returned. If an unsupported MIME type is supplied, then  a status code 406 is returned. text/plain
Data-API-Version optional Used to specify version of the API to use. version 1

 

Request
https://api.finra.org/data/group/OTCMarket/name/weeklysummary?limit=10&fields=issueSymbolIdentifier,issueName,weekStartDate,totalWeeklyShareQuantity

 

Response
"issueSymbolIdentifier","issueName","totalWeeklyShareQuantity"
"A","Agilent Technologies","5841"
"A","Agilent Technologies","9700"
"A","Agilent Technologies","92700"
"A","Agilent Technologies","14217"
"A","Agilent Technologies","141400"
"A","Agilent Technologies","69700"
"A","Agilent Technologies","1851131"
"A","Agilent Technologies","181689"
"A","Agilent Technologies","13800"
"A","Agilent Technologies","32711"

 

POST Data

Returns data from specified dataset in delimited (default) or JSON format depending on the value of the ACCEPT header in the request. Advanced selection criteria including filters are available via the request payload. The request payload must be a validly formatted JSON object.

POST /data/group/{group name}/name/{dataset name}

parameter description example default
fields Comma delimited list of field names to retrieve. "fields" : ["mpid","issuesymbolidentifier" ] all fields are returned
compareFilters Used for field value comparisons with standard operators. GREATER, LESSER, EQUALS, GTE, LTE, NOT_EQUAL. "compareFilters": [{
"fieldName" "ats_mp_id",
"fieldValue" "ADAM",
"compareType" "EQUAL"
}]
n/a
dateRangeFilters Used for providing a date range for a specific field value. Date format is YYYY-MM-DD or YYYY-MM-DD HH:mm:ss.SSS.

"dateRangeFilters": [ {

    "startDate" "2017-02-10",

    "endDate" "2017-05-10",

    "fieldName" "trade_time"

  } ]

n/a
domainFilters Used for specifying a filter based on specific values for a field. "domainFilters": [{
"fieldName" "MarketCenter",
"values" : [ "A""B""C""J" ]
}]
n/a
limit

Number of records to return. 

NOTE: See the Platform Usage Limits page for more details.

"limit" : 5000 1000
offset

Record number to start with (exclusive). Range of records to be returned is offset record plus limit. If offset is 0 and limit is 20, then records 1 to 20 are returned for a total of 20 records. If offset is 10 and limit is 100, then records 11 to 110 are returned.

IMPORTANT: The offset has a max value of 500,000. See the Platform Usage Limits page for details on using filters in conjunction with the offset parameter to access records beyond a 500,000 offset range.

"offset" : 2000 0
quoteValues Can be used to specify quoted values when Accept header is set to text/plain. "quoteValues" false true
delimiter Can be used to specify a character delimiter when Accept header isset to text/plain. Allowed values are pipe (|), comma, tab, or control A. "delimiter" "|" comma
async The API request type. Set to true to specify an asynchronous request. Set to false to specify an synchronous request. "async" : true false
sortFields Comma delimited list of field names to sort by. You can prepend a + or - before the field name to specify an ascending or descending sort on that field respectively. See the Sorting Restrictions page for more details.  "-last_updated" ] sorting not performed
header required description default
Authorization required

Contains the word Basic followed by a space and a base64-encoded string of ther form "clientid:clientSecret"

n/a
Accept optional Can be used to specify a format for the data returned. Supports (application/json, text/plain). If the native data format cannot be converted between JSON/CSV then a status code of 400 will be returned. If an unsupported MIME type is supplied, then  a status code 406 is returned. text/plain
Data-API-Version optional Used to specify version of the API to use. version 1

 

Request
POST https://api.finra.org/data/group/otcmarket/name/weeklysummary

 

Request Payload
{
"fields":["issueSymbolIdentifier", "issueName", "totalWeeklyShareQuantity","totalWeeklyTradeCount","lastUpdateDate"],  
"compareFilters": [ 
{  "compareType": "equal", "fieldName": "tierIdentifier", "fieldValue": "T1" },
{  "compareType": "greater", "fieldName": "summaryStartDate", "fieldValue":"2019-09-01"},
{  "compareType": "equal", "fieldName": "summaryTypeCode", "fieldValue": "OTC_W_SMBL" },
{  "compareType": "equal", "fieldName": "issueSymbolIdentifier", "fieldValue" : "AAPL"}
]
}

 

Response
[

{

"totalWeeklyShareQuantity": 26209776,

"totalWeeklyTradeCount": 123120,

"issueSymbolIdentifier": "AAPL",

"issueName": "Apple Inc. Common Stock",

"lastUpdateDate": "2019-09-23"

},

{

"totalWeeklyShareQuantity": 59995277,

"totalWeeklyTradeCount": 296668,

"issueSymbolIdentifier": "AAPL",

"issueName": "Apple Inc. Common Stock",

"lastUpdateDate": "2019-09-30"

},

{

"totalWeeklyShareQuantity": 59932154,

"totalWeeklyTradeCount": 256271,

"issueSymbolIdentifier": "AAPL",

"issueName": "Apple Inc. Common Stock",

"lastUpdateDate": "2019-10-21"

},

{

"totalWeeklyShareQuantity": 36183038,

"totalWeeklyTradeCount": 157411,

"issueSymbolIdentifier": "AAPL",

"issueName": "Apple Inc. Common Stock",

"lastUpdateDate": "2019-10-17"

},

{

"totalWeeklyShareQuantity": 46913014,

"totalWeeklyTradeCount": 167054,

"issueSymbolIdentifier": "AAPL",

"issueName": "Apple Inc. Common Stock",

"lastUpdateDate": "2019-10-07"

}

]

 

GET Versions

Returns a list of available API versions in descending order.  All API endpoints are versioned under the same value.

GET /versions

None.

header required description default
Authorization optional

Contains the word Basic followed by a space and a base64-encoded string of ther form "clientid:clientSecret"

n/a
Data-API-Version optional Used to specify version of the API to use. Version 1

 

Request
https://api.finra.org/versions

 

Response
[ {
  "version" : "1",
  "revisions" : "initial version",
  "datePublished" : "2019-10-21"
} ]

 

API Explorer

The FINRA API Explorer provides interactive API documentation that lets you try out API calls directly via the developer.finra.org website. Note that the API calls made via the API Explorer only work against mock or test data. 

It is available for many of the Query API datasets below. Such datasets will have 'API Explorer (Playground)' as an option in their respective sections and a 'TEST IT OUT' button which you can click to go to the dataset's explorer page and try it out. 

Equity

The Equity API datasets provide access to OTC trade and equity data. 

Blocks Summary

Aggregated ATS trade data in NMS stocks that meets certain share based and dollar based thresholds.

Dataset Info:

group dataset test dataset
otcMarket blocksSummary blocksSummaryMock

 

Sample Request
https://api.finra.org/data/group/otcMarket/name/blocksSummaryMock?limit=5

 

Sample Response
[
    {
        "atsOtc": "ATS",
        "ATSBlockSharePercent": 12.55,
        "lastUpdateDate": "2020-01-06",
        "ATSBlockBusinessSharePercent": 8.08,
        "averageTradeSize": 133,
        "averageBlockSizeRank": 22,
        "ATSBlockCount": 73653,
        "initialPublishedDate": "2020-01-06",
        "summaryStartDate": "2019-11-01",
        "ATSBlockQuantity": 255646555,
        "ATSShareRank": 1,
        "averageBlockSize": 3471,
        "ATSBlockTradeRank": 1,
        "averageTradeSizeRank": 30,
        "ATSTradeRank": 1,
        "ATSBlockBusinessTradePercent": 0.31,
        "MPID": "UBSA",
        "monthStartDate": "2019-11-01",
        "ATSSharePercent": 18.9,
        "ATSBlockShareRank": 1,
        "ATSBlockTradePercent": 13.28,
        "marketParticipantName": "UBS ATS",
        "summaryTypeCode": "2K",
        "ATSTradePercent": 27.05,
        "lastReportedDate": "2019-11-29",
        "ATSBlockBusinessTradeRank": 27,
        "totalShareQuantity": 3165347832,
        "ATSBlockBusinessShareRank": 26,
        "summaryTypeDescription": "2K to <10K",
        "totalTradeCount": 23787089
    },
    {
        "atsOtc": "ATS",
        "ATSBlockSharePercent": 10.41,
        "lastUpdateDate": "2020-01-06",
        "ATSBlockBusinessSharePercent": 20.95,
        "averageTradeSize": 964,
        "averageBlockSizeRank": 7,
        "ATSBlockCount": 46437,
        "initialPublishedDate": "2020-01-06",
        "summaryStartDate": "2019-11-01",
        "ATSBlockQuantity": 212032300,
        "ATSShareRank": 7,
        "averageBlockSize": 4566,
        "ATSBlockTradeRank": 5,
        "averageTradeSizeRank": 10,
        "ATSTradeRank": 18,
        "ATSBlockBusinessTradePercent": 4.42,
        "MPID": "BIDS",
        "monthStartDate": "2019-11-01",
        "ATSSharePercent": 6.05,
        "ATSBlockShareRank": 2,
        "ATSBlockTradePercent": 8.38,
        "marketParticipantName": "BIDS ATS",
        "summaryTypeCode": "2K",
        "ATSTradePercent": 1.19,
        "lastReportedDate": "2019-11-29",
        "ATSBlockBusinessTradeRank": 9,
        "totalShareQuantity": 1012322720,
        "ATSBlockBusinessShareRank": 7,
        "summaryTypeDescription": "2K to <10K",
        "totalTradeCount": 1049737
    },
    {
        "atsOtc": "ATS",
        "ATSBlockSharePercent": 9.16,
        "lastUpdateDate": "2020-01-06",
        "ATSBlockBusinessSharePercent": 12.21,
        "averageTradeSize": 172,
        "averageBlockSizeRank": 20,
        "ATSBlockCount": 53337,
        "initialPublishedDate": "2020-01-06",
        "summaryStartDate": "2019-11-01",
        "ATSBlockQuantity": 186496493,
        "ATSShareRank": 2,
        "averageBlockSize": 3497,
        "ATSBlockTradeRank": 2,
        "averageTradeSizeRank": 26,
        "ATSTradeRank": 3,
        "ATSBlockBusinessTradePercent": 0.6,
        "MPID": "CROS",
        "monthStartDate": "2019-11-01",
        "ATSSharePercent": 9.12,
        "ATSBlockShareRank": 3,
        "ATSBlockTradePercent": 9.62,
        "marketParticipantName": "CROSSFINDER",
        "summaryTypeCode": "2K",
        "ATSTradePercent": 10.07,
        "lastReportedDate": "2019-12-02",
        "ATSBlockBusinessTradeRank": 24,
        "totalShareQuantity": 1527483198,
        "ATSBlockBusinessShareRank": 18,
        "summaryTypeDescription": "2K to <10K",
        "totalTradeCount": 8857884
    },
    {
        "atsOtc": "ATS",
        "ATSBlockSharePercent": 8.6,
        "lastUpdateDate": "2020-01-06",
        "ATSBlockBusinessSharePercent": 13.16,
        "averageTradeSize": 210,
        "averageBlockSizeRank": 23,
        "ATSBlockCount": 51462,
        "initialPublishedDate": "2020-01-06",
        "summaryStartDate": "2019-11-01",
        "ATSBlockQuantity": 175131200,
        "ATSShareRank": 3,
        "averageBlockSize": 3403,
        "ATSBlockTradeRank": 3,
        "averageTradeSizeRank": 18,
        "ATSTradeRank": 5,
        "ATSBlockBusinessTradePercent": 0.81,
        "MPID": "MSPL",
        "monthStartDate": "2019-11-01",
        "ATSSharePercent": 7.95,
        "ATSBlockShareRank": 4,
        "ATSBlockTradePercent": 9.28,
        "marketParticipantName": "MS POOL (ATS-4)",
        "summaryTypeCode": "2K",
        "ATSTradePercent": 7.21,
        "lastReportedDate": "2019-11-29",
        "ATSBlockBusinessTradeRank": 18,
        "totalShareQuantity": 1331038011,
        "ATSBlockBusinessShareRank": 17,
        "summaryTypeDescription": "2K to <10K",
        "totalTradeCount": 6337247
    },
    {
        "atsOtc": "ATS",
        "ATSBlockSharePercent": 8.33,
        "lastUpdateDate": "2020-01-06",
        "ATSBlockBusinessSharePercent": 13.53,
        "averageTradeSize": 172,
        "averageBlockSizeRank": 18,
        "ATSBlockCount": 48314,
        "initialPublishedDate": "2020-01-06",
        "summaryStartDate": "2019-11-01",
        "ATSBlockQuantity": 169548640,
        "ATSShareRank": 5,
        "averageBlockSize": 3509,
        "ATSBlockTradeRank": 4,
        "averageTradeSizeRank": 26,
        "ATSTradeRank": 4,
        "ATSBlockBusinessTradePercent": 0.66,
        "MPID": "JPMX",
        "monthStartDate": "2019-11-01",
        "ATSSharePercent": 7.48,
        "ATSBlockShareRank": 5,
        "ATSBlockTradePercent": 8.71,
        "marketParticipantName": "JPM-X",
        "summaryTypeCode": "2K",
        "ATSTradePercent": 8.29,
        "lastReportedDate": "2019-11-29",
        "ATSBlockBusinessTradeRank": 20,
        "totalShareQuantity": 1252865110,
        "ATSBlockBusinessShareRank": 16,
        "summaryTypeDescription": "2K to <10K",
        "totalTradeCount": 7291405
    }
]

 

Sample Request
https://api.finra.org/data/group/otcMarket/name/blocksSummaryMock

 

Sample Request Payload
{
"limit":5,
"fields":["MPID","marketParticipantName","summaryStartDate","totalTradeCount","totalShareQuantity"],  
"compareFilters": [ 
{"compareType": "greater", "fieldName": "summaryStartDate", "fieldValue": "2019-11-01" }
]
}

 

Sample Response
[
    {
        "totalShareQuantity": 2872284803,
        "MPID": "UBSA",
        "totalTradeCount": 22078770,
        "summaryStartDate": "2019-12-01",
        "marketParticipantName": "UBS ATS"
    },
    {
        "totalShareQuantity": 863401533,
        "MPID": "BIDS",
        "totalTradeCount": 909301,
        "summaryStartDate": "2019-12-01",
        "marketParticipantName": "BIDS ATS"
    },
    {
        "totalShareQuantity": 1109037768,
        "MPID": "JPMX",
        "totalTradeCount": 6911113,
        "summaryStartDate": "2019-12-01",
        "marketParticipantName": "JPM-X"
    },
    {
        "totalShareQuantity": 1550565641,
        "MPID": "CROS",
        "totalTradeCount": 9020187,
        "summaryStartDate": "2019-12-01",
        "marketParticipantName": "CROSSFINDER"
    },
    {
        "totalShareQuantity": 1141992930,
        "MPID": "MSPL",
        "totalTradeCount": 5589283,
        "summaryStartDate": "2019-12-01",
        "marketParticipantName": "MS POOL (ATS-4)"
    }
]

 

Equity Short Interest

Deprecated

OTC equity short positions reported by FINRA member firms.

Dataset Info:

group name dataset name test dataset name
otcMarket equityShortInterest equityShortInterestMock

 

Sample Request
https://api.finra.org/data/group/otcMarket/name/equityShortInterestMock?limit=5

 

Sample Response
[
    {
        "issueSymbolIdentifier": "AAALF",
        "issueName": "Aareal Bank AG AKT",
        "marketCategoryDescription": "Other OTC",
        "marketCategoryCode": "u",
        "changePercent": 6.3,
        "currentShortShareNumber": 111989,
        "daysToCoverNumber": 999.99,
        "settlementDate": "2019-01-15",
        "previousShortShareNumber": 105349,
        "averageShortShareNumber": 0,
        "percentageChangefromPreviousShort": 6640
    },
    {
        "issueSymbolIdentifier": "AABVF",
        "issueName": "Aberdeen International Inc Ord",
        "marketCategoryDescription": "Other OTC",
        "marketCategoryCode": "u",
        "changePercent": 0,
        "currentShortShareNumber": 2500,
        "daysToCoverNumber": 1,
        "settlementDate": "2019-01-15",
        "previousShortShareNumber": 2500,
        "averageShortShareNumber": 10523,
        "percentageChangefromPreviousShort": 0
    },
    {
        "issueSymbolIdentifier": "AACAF",
        "issueName": "AAC Technologies Holdings Inc",
        "marketCategoryDescription": "Other OTC",
        "marketCategoryCode": "u",
        "changePercent": -1.62,
        "currentShortShareNumber": 7497609,
        "daysToCoverNumber": 999.99,
        "settlementDate": "2019-01-15",
        "previousShortShareNumber": 7620711,
        "averageShortShareNumber": 7155,
        "percentageChangefromPreviousShort": -123102
    },
    {
        "issueSymbolIdentifier": "AACAY",
        "issueName": "AAC Technologies Holdings Inc",
        "marketCategoryDescription": "Other OTC",
        "marketCategoryCode": "u",
        "changePercent": 697.49,
        "currentShortShareNumber": 165671,
        "daysToCoverNumber": 1,
        "settlementDate": "2019-01-15",
        "previousShortShareNumber": 20774,
        "averageShortShareNumber": 306485,
        "percentageChangefromPreviousShort": 144897
    },
    {
        "issueSymbolIdentifier": "AACMZ",
        "issueName": "Asia Cement Corp Global Deposi",
        "marketCategoryDescription": "Other OTC",
        "marketCategoryCode": "u",
        "changePercent": 0,
        "currentShortShareNumber": 1,
        "daysToCoverNumber": 999.99,
        "settlementDate": "2019-01-15",
        "previousShortShareNumber": 1,
        "averageShortShareNumber": 0,
        "percentageChangefromPreviousShort": 0
    }
]

 

Sample Request
https://api.finra.org/data/group/otcMarket/name/equityShortInterestMock

 

Sample Request Payload
{
"limit":5,
"fields":["issueSymbolIdentifier","settlementDate","issueName","marketCategoryCode","marketCategoryDescription"],  
"compareFilters": [ 
{"compareType": "equal", "fieldName": "issueSymbolIdentifier", "fieldValue": "AACMZ" }
]
}
 

 

Sample Response
[
    {
        "issueSymbolIdentifier": "AACMZ",
        "issueName": "Asia Cement Corp Global Deposi",
        "marketCategoryDescription": "Other OTC",
        "marketCategoryCode": "u",
        "settlementDate": "2019-01-15"
    },
    {
        "issueSymbolIdentifier": "AACMZ",
        "issueName": "Asia Cement Corp Global Deposi",
        "marketCategoryDescription": "Other OTC",
        "marketCategoryCode": "u",
        "settlementDate": "2019-01-31"
    },
    {
        "issueSymbolIdentifier": "AACMZ",
        "issueName": "Asia Cement Corp Global Deposi",
        "marketCategoryDescription": "Other OTC",
        "marketCategoryCode": "u",
        "settlementDate": "2019-02-15"
    },
    {
        "issueSymbolIdentifier": "AACMZ",
        "issueName": "Asia Cement Corp Global Deposi",
        "marketCategoryDescription": "Other OTC",
        "marketCategoryCode": "u",
        "settlementDate": "2019-02-28"
    },
    {
        "issueSymbolIdentifier": "AACMZ",
        "issueName": "Asia Cement Corp Global Deposi",
        "marketCategoryDescription": "Other OTC",
        "marketCategoryCode": "u",
        "settlementDate": "2019-03-15"
    }
]

 

Equity Short Interest Standardized

OTC equity short positions reported by FINRA member firm in the new industry standardized format.

Dataset Info:

group dataset test dataset
otcMarket equityShortInterestStandardized equityShortInterestStandardizedMock

 

Sample Request
https://api.finra.org/data/group/otcMarket/name/equityShortInterestStandardizedMock?limit=5

 

Sample Response
[
    {
        "stockSplitFlag": null,
        "previousShortPositionQuantity": 49670715,
        "accountingDate": 20201231,
        "averageDailyVolumeQuantity": 1908670,
        "issueName": "Bombardier Inc. Class B Shares",
        "currentShortPositionQuantity": 49814046,
        "changePreviousNumber": 143331,
        "settlementDate": "2020-12-31",
        "marketClassCode": "OTC",
        "daysToCoverQuantity": 26.1,
        "issuerServicesGroupExchangeCode": "S",
        "revisionFlag": null,
        "changePercent": 0.29,
        "securitiesInformationProcessorSymbolIdentifier": "BDRBF"
    },
    {
        "stockSplitFlag": null,
        "previousShortPositionQuantity": 247241628,
        "accountingDate": 20201231,
        "averageDailyVolumeQuantity": 273245,
        "issueName": "GCL Poly Energy Holdings Ltd O",
        "currentShortPositionQuantity": 103933455,
        "changePreviousNumber": -143308173,
        "settlementDate": "2020-12-31",
        "marketClassCode": "OTC",
        "daysToCoverQuantity": 380.37,
        "issuerServicesGroupExchangeCode": "S",
        "revisionFlag": null,
        "changePercent": -57.96,
        "securitiesInformationProcessorSymbolIdentifier": "GCPEF"
    },
    {
        "stockSplitFlag": null,
        "previousShortPositionQuantity": 3,
        "accountingDate": 20201231,
        "averageDailyVolumeQuantity": 4162867982,
        "issueName": "Healthier Choices Management C",
        "currentShortPositionQuantity": 3,
        "changePreviousNumber": 0,
        "settlementDate": "2020-12-31",
        "marketClassCode": "OTC",
        "daysToCoverQuantity": 1,
        "issuerServicesGroupExchangeCode": "S",
        "revisionFlag": null,
        "changePercent": 0,
        "securitiesInformationProcessorSymbolIdentifier": "HCMC"
    },
    {
        "stockSplitFlag": null,
        "previousShortPositionQuantity": 137289912,
        "accountingDate": 20201231,
        "averageDailyVolumeQuantity": 222534495,
        "issueName": "ProTek Capital, Inc.  Common S",
        "currentShortPositionQuantity": 140943118,
        "changePreviousNumber": 3653206,
        "settlementDate": "2020-12-31",
        "marketClassCode": "OTC",
        "daysToCoverQuantity": 1,
        "issuerServicesGroupExchangeCode": "S",
        "revisionFlag": null,
        "changePercent": 2.66,
        "securitiesInformationProcessorSymbolIdentifier": "PRPM"
    },
    {
        "stockSplitFlag": null,
        "previousShortPositionQuantity": 49238367,
        "accountingDate": 20201231,
        "averageDailyVolumeQuantity": 54536355,
        "issueName": "Western Pacific Minerals Ltd C",
        "currentShortPositionQuantity": 55745821,
        "changePreviousNumber": 6507454,
        "settlementDate": "2020-12-31",
        "marketClassCode": "OTC",
        "daysToCoverQuantity": 1.02,
        "issuerServicesGroupExchangeCode": "S",
        "revisionFlag": null,
        "changePercent": 13.22,
        "securitiesInformationProcessorSymbolIdentifier": "WPMLF"
    }
]

 

Sample Request
https://api.finra.org/data/group/otcMarket/name/equityShortInterestStandardizedMock

 

Sample Request Payload
{
"limit":5,
"fields":["accountingDate","securitiesInformationProcessorSymbolIdentifier","issueName","issuerServicesGroupExchangeCode","marketClassCode"],  
"compareFilters": [ 
{"compareType": "equal", "fieldName": "securitiesInformationProcessorSymbolIdentifier", "fieldValue": "HCMC" }
]
}

 

Sample Response
[
    {
        "accountingDate": 20201231,
        "issueName": "Healthier Choices Management C",
        "issuerServicesGroupExchangeCode": "S",
        "securitiesInformationProcessorSymbolIdentifier": "HCMC",
        "marketClassCode": "OTC"
    },
    {
        "accountingDate": 20201215,
        "issueName": "Healthier Choices Management C",
        "issuerServicesGroupExchangeCode": "S",
        "securitiesInformationProcessorSymbolIdentifier": "HCMC",
        "marketClassCode": "OTC"
    },
    {
        "accountingDate": 20201130,
        "issueName": "Healthier Choices Management C",
        "issuerServicesGroupExchangeCode": "S",
        "securitiesInformationProcessorSymbolIdentifier": "HCMC",
        "marketClassCode": "OTC"
    },
    {
        "accountingDate": 20201113,
        "issueName": "Healthier Choices Management C",
        "issuerServicesGroupExchangeCode": "S",
        "securitiesInformationProcessorSymbolIdentifier": "HCMC",
        "marketClassCode": "OTC"
    },
    {
        "accountingDate": 20201030,
        "issueName": "Healthier Choices Management C",
        "issuerServicesGroupExchangeCode": "S",
        "securitiesInformationProcessorSymbolIdentifier": "HCMC",
        "marketClassCode": "OTC"
    }
]

 

Monthly Summary

Monthly aggregate trade data for OTC (non-ATS) trading data for each firm with trade reporting obligations under FINRA rules.

Dataset Info:

group dataset test dataset
otcMarket monthlySummary monthlySummaryMock

 

Sample Request
https://api.finra.org/data/group/otcMarket/name/monthlySummaryMock?limit=5

 

Sample Response
[
    {
        "issueSymbolIdentifier": null,
        "issueName": null,
        "lastUpdateDate": "2020-01-06",
        "lastReportedDate": "2019-11-29",
        "initialPublishedDate": "2020-01-06",
        "tierIdentifier": "OTCE",
        "summaryStartDate": "2019-11-01",
        "monthStartDate": "2019-11-01",
        "totalMonthlyTradeCount": 6543,
        "firmCRDNumber": 281867,
        "productTypeCode": null,
        "marketParticipantName": "OLD MISSION MARKETS LLC",
        "totalMonthlyShareQuantity": 100117725,
        "summaryTypeCode": "OTC_M_FIRM"
    },
    {
        "issueSymbolIdentifier": "AAVMY",
        "issueName": "Abn Amro BK N V Amsterdam Brh American Depositary Receipts - Unsponsored (Netherlands)",
        "lastUpdateDate": "2020-01-06",
        "lastReportedDate": "2019-11-29",
        "initialPublishedDate": "2020-01-06",
        "tierIdentifier": "OTCE",
        "summaryStartDate": "2019-11-01",
        "monthStartDate": "2019-11-01",
        "totalMonthlyTradeCount": 1720,
        "firmCRDNumber": 0,
        "productTypeCode": null,
        "marketParticipantName": "De Minimis Firms",
        "totalMonthlyShareQuantity": 3684028,
        "summaryTypeCode": "OTC_M_SMBL_FIRM"
    },
    {
        "issueSymbolIdentifier": "ACAN",
        "issueName": "Americann, Inc. Common Stock",
        "lastUpdateDate": "2020-01-06",
        "lastReportedDate": "2019-11-29",
        "initialPublishedDate": "2020-01-06",
        "tierIdentifier": "OTCE",
        "summaryStartDate": "2019-11-01",
        "monthStartDate": "2019-11-01",
        "totalMonthlyTradeCount": 645,
        "firmCRDNumber": 0,
        "productTypeCode": null,
        "marketParticipantName": "De Minimis Firms",
        "totalMonthlyShareQuantity": 449681,
        "summaryTypeCode": "OTC_M_SMBL_FIRM"
    },
    {
        "issueSymbolIdentifier": "ACNDF",
        "issueName": "Ascendas India Trust Units (Singapore)",
        "lastUpdateDate": "2020-01-06",
        "lastReportedDate": "2019-11-21",
        "initialPublishedDate": "2020-01-06",
        "tierIdentifier": "OTCE",
        "summaryStartDate": "2019-11-01",
        "monthStartDate": "2019-11-01",
        "totalMonthlyTradeCount": 9,
        "firmCRDNumber": 0,
        "productTypeCode": null,
        "marketParticipantName": "De Minimis Firms",
        "totalMonthlyShareQuantity": 35000,
        "summaryTypeCode": "OTC_M_SMBL_FIRM"
    },
    {
        "issueSymbolIdentifier": "ALGWF",
        "issueName": "Alliance Growers Corp Ordinary Shares (Canada)",
        "lastUpdateDate": "2020-01-06",
        "lastReportedDate": "2019-11-29",
        "initialPublishedDate": "2020-01-06",
        "tierIdentifier": "OTCE",
        "summaryStartDate": "2019-11-01",
        "monthStartDate": "2019-11-01",
        "totalMonthlyTradeCount": 45,
        "firmCRDNumber": 0,
        "productTypeCode": null,
        "marketParticipantName": "De Minimis Firms",
        "totalMonthlyShareQuantity": 189960,
        "summaryTypeCode": "OTC_M_SMBL_FIRM"
    }
]

 

Sample Request
https://api.finra.org/data/group/otcMarket/name/monthlySummaryMock

 

Sample Request Payload
{
"limit":5,
"fields":["issueSymbolIdentifier","issueName","firmCRDNumber","marketParticipantName","tierIdentifier"],  
"compareFilters": [ 
{"compareType": "greater", "fieldName": "totalMonthlyTradeCount", "fieldValue": 5000 }
]
}
 

 

Sample Response
[
    {
        "issueSymbolIdentifier": null,
        "issueName": null,
        "firmCRDNumber": 281867,
        "tierIdentifier": "OTCE",
        "marketParticipantName": "OLD MISSION MARKETS LLC"
    },
    {
        "issueSymbolIdentifier": "GRWG",
        "issueName": "Growgeneration Corp Common Stock",
        "firmCRDNumber": 0,
        "tierIdentifier": "OTCE",
        "marketParticipantName": "De Minimis Firms"
    },
    {
        "issueSymbolIdentifier": null,
        "issueName": null,
        "firmCRDNumber": 139515,
        "tierIdentifier": "OTCE",
        "marketParticipantName": "MCAP LLC"
    },
    {
        "issueSymbolIdentifier": "RHHBY",
        "issueName": "Roche Holdings AG Basel American Depositary Shares",
        "firmCRDNumber": null,
        "tierIdentifier": "OTCE",
        "marketParticipantName": null
    },
    {
        "issueSymbolIdentifier": "SPRWF",
        "issueName": "The Supreme Cannabis Co Inc. Ordinary Shares",
        "firmCRDNumber": null,
        "tierIdentifier": "OTCE",
        "marketParticipantName": null
    }
]

 

OTC Block Summary

Aggregated OTC (Non-ATS) trade data in NMS stocks that meets certain share based and dollar based thresholds.

Dataset Info:

group dataset test dataset
otcMarket otcBlocksSummary otcBlocksSummaryMock

 

Sample Request
https://api.finra.org/data/group/otcMarket/name/otcBlocksSummaryMock?limit=5

 

Sample Response
[
    {
        "OTCBlockTradePercent": 0,
        "atsOtc": "OTC",
        "OTCBlockShareRank": 77,
        "lastUpdateDate": "2020-01-06",
        "averageTradeSize": 1155000,
        "averageBlockSizeRank": 1,
        "initialPublishedDate": "2020-01-06",
        "summaryStartDate": "2019-11-01",
        "crdFirmName": "H.C.WAINWRIGHT & CO., LLC",
        "OTCTradePercent": 0,
        "averageBlockSize": 1155000,
        "averageTradeSizeRank": 1,
        "monthStartDate": "2019-11-01",
        "OTCBlockSharePercent": 0.04,
        "summaryTypeCode": "10K",
        "OTCBlockTradeRank": 140,
        "lastReportedDate": "2019-11-19",
        "OTCSharePercent": 0.02,
        "OTCBlockCount": 5,
        "OTCBlockBusinessShareRank": 1,
        "OTCBlockQuantity": 5775000,
        "OTCTradeRank": 169,
        "totalShareQuantity": 5775000,
        "OTCShareRank": 86,
        "OTCBlockBusinessSharePercent": 100,
        "summaryTypeDescription": "10K+ Shares",
        "OTCBlockBusinessTradeRank": 1,
        "totalTradeCount": 5,
        "OTCBlockBusinessTradePercent": 100
    },
    {
        "OTCBlockTradePercent": 0,
        "atsOtc": "OTC",
        "OTCBlockShareRank": 87,
        "lastUpdateDate": "2020-01-06",
        "averageTradeSize": 687500,
        "averageBlockSizeRank": 3,
        "initialPublishedDate": "2020-01-06",
        "summaryStartDate": "2019-11-01",
        "crdFirmName": "TRADITION SECURITIES AND DERIVATIVES INC.",
        "OTCTradePercent": 0,
        "averageBlockSize": 687500,
        "averageTradeSizeRank": 2,
        "monthStartDate": "2019-11-01",
        "OTCBlockSharePercent": 0.03,
        "summaryTypeCode": "10K",
        "OTCBlockTradeRank": 134,
        "lastReportedDate": "2019-12-02",
        "OTCSharePercent": 0.01,
        "OTCBlockCount": 6,
        "OTCBlockBusinessShareRank": 1,
        "OTCBlockQuantity": 4125000,
        "OTCTradeRank": 162,
        "totalShareQuantity": 4125000,
        "OTCShareRank": 94,
        "OTCBlockBusinessSharePercent": 100,
        "summaryTypeDescription": "10K+ Shares",
        "OTCBlockBusinessTradeRank": 1,
        "totalTradeCount": 6,
        "OTCBlockBusinessTradePercent": 100
    },
    {
        "OTCBlockTradePercent": 0,
        "atsOtc": "OTC",
        "OTCBlockShareRank": 97,
        "lastUpdateDate": "2020-01-06",
        "averageTradeSize": 562400,
        "averageBlockSizeRank": 5,
        "initialPublishedDate": "2020-01-06",
        "summaryStartDate": "2019-11-01",
        "crdFirmName": "EARLYBIRDCAPITAL, INC.",
        "OTCTradePercent": 0,
        "averageBlockSize": 562400,
        "averageTradeSizeRank": 3,
        "monthStartDate": "2019-11-01",
        "OTCBlockSharePercent": 0.02,
        "summaryTypeCode": "10K",
        "OTCBlockTradeRank": 143,
        "lastReportedDate": "2019-11-25",
        "OTCSharePercent": 0.01,
        "OTCBlockCount": 4,
        "OTCBlockBusinessShareRank": 1,
        "OTCBlockQuantity": 2249600,
        "OTCTradeRank": 174,
        "totalShareQuantity": 2249600,
        "OTCShareRank": 104,
        "OTCBlockBusinessSharePercent": 100,
        "summaryTypeDescription": "10K+ Shares",
        "OTCBlockBusinessTradeRank": 1,
        "totalTradeCount": 4,
        "OTCBlockBusinessTradePercent": 100
    },
    {
        "OTCBlockTradePercent": 0,
        "atsOtc": "OTC",
        "OTCBlockShareRank": 134,
        "lastUpdateDate": "2020-01-06",
        "averageTradeSize": 381640,
        "averageBlockSizeRank": 7,
        "initialPublishedDate": "2020-01-06",
        "summaryStartDate": "2019-11-01",
        "crdFirmName": "TD AMERITRADE CLEARING, INC.",
        "OTCTradePercent": 0,
        "averageBlockSize": 381640,
        "averageTradeSizeRank": 5,
        "monthStartDate": "2019-11-01",
        "OTCBlockSharePercent": 0,
        "summaryTypeCode": "10K",
        "OTCBlockTradeRank": 168,
        "lastReportedDate": "2019-11-18",
        "OTCSharePercent": 0,
        "OTCBlockCount": 1,
        "OTCBlockBusinessShareRank": 1,
        "OTCBlockQuantity": 381640,
        "OTCTradeRank": 198,
        "totalShareQuantity": 381640,
        "OTCShareRank": 143,
        "OTCBlockBusinessSharePercent": 100,
        "summaryTypeDescription": "10K+ Shares",
        "OTCBlockBusinessTradeRank": 1,
        "totalTradeCount": 1,
        "OTCBlockBusinessTradePercent": 100
    },
    {
        "OTCBlockTradePercent": 0,
        "atsOtc": "OTC",
        "OTCBlockShareRank": 99,
        "lastUpdateDate": "2020-01-06",
        "averageTradeSize": 352144,
        "averageBlockSizeRank": 8,
        "initialPublishedDate": "2020-01-06",
        "summaryStartDate": "2019-11-01",
        "crdFirmName": "CIBC WORLD MARKETS CORP.",
        "OTCTradePercent": 0,
        "averageBlockSize": 352144,
        "averageTradeSizeRank": 6,
        "monthStartDate": "2019-11-01",
        "OTCBlockSharePercent": 0.01,
        "summaryTypeCode": "10K",
        "OTCBlockTradeRank": 134,
        "lastReportedDate": "2019-11-26",
        "OTCSharePercent": 0.01,
        "OTCBlockCount": 6,
        "OTCBlockBusinessShareRank": 1,
        "OTCBlockQuantity": 2112863,
        "OTCTradeRank": 162,
        "totalShareQuantity": 2112863,
        "OTCShareRank": 105,
        "OTCBlockBusinessSharePercent": 100,
        "summaryTypeDescription": "10K+ Shares",
        "OTCBlockBusinessTradeRank": 1,
        "totalTradeCount": 6,
        "OTCBlockBusinessTradePercent": 100
    }
]

 

Sample Request
https://api.finra.org/data/group/otcMarket/name/otcBlocksSummaryMock

 

Sample Request Payload
{
"limit":5,
"fields":["crdFirmName","summaryStartDate","totalTradeCount","totalShareQuantity","averageTradeSize"],  
"compareFilters": [ 
{"compareType": "greater", "fieldName": "totalTradeCount", "fieldValue": 5 }
]
}
 

 

Sample Response
[
    {
        "crdFirmName": "TRADITION SECURITIES AND DERIVATIVES INC.",
        "totalShareQuantity": 4125000,
        "averageTradeSize": 687500,
        "totalTradeCount": 6,
        "summaryStartDate": "2019-11-01"
    },
    {
        "crdFirmName": "CIBC WORLD MARKETS CORP.",
        "totalShareQuantity": 2112863,
        "averageTradeSize": 352144,
        "totalTradeCount": 6,
        "summaryStartDate": "2019-11-01"
    },
    {
        "crdFirmName": "FBN SECURITIES, INC.",
        "totalShareQuantity": 3748198,
        "averageTradeSize": 187410,
        "totalTradeCount": 20,
        "summaryStartDate": "2019-11-01"
    },
    {
        "crdFirmName": "ITAU BBA USA SECURITIES, INC.",
        "totalShareQuantity": 533632,
        "averageTradeSize": 88939,
        "totalTradeCount": 6,
        "summaryStartDate": "2019-11-01"
    },
    {
        "crdFirmName": "AEGIS CAPITAL CORP.",
        "totalShareQuantity": 301320,
        "averageTradeSize": 50220,
        "totalTradeCount": 6,
        "summaryStartDate": "2019-11-01"
    }
]

 

Reg SHO Daily Short Sale Volume

Daily short sale aggregated volume by security for all short sale trades executed and reported to a FINRA trade reporting facility.

Dataset Info:

group dataset test dataset
otcMarket regShoDaily regShoDailyMock

 

Sample Request
https://api.finra.org/data/group/otcMarket/name/regShoDailyMock?limit=5

 

Sample Response
[
    {
        "reportingFacilityCode": "NQTRF",
        "totalParQuantity": 134248,
        "shortParQuantity": 41895,
        "marketCode": "Q",
        "tradeReportDate": "2021-05-03",
        "securitiesInformationProcessorSymbolIdentifier": "A",
        "shortExemptParQuantity": 1014
    },
    {
        "reportingFacilityCode": "NYTRF",
        "totalParQuantity": 15639,
        "shortParQuantity": 4234,
        "marketCode": "N",
        "tradeReportDate": "2021-05-03",
        "securitiesInformationProcessorSymbolIdentifier": "A",
        "shortExemptParQuantity": 0
    },
    {
        "reportingFacilityCode": "NCTRF",
        "totalParQuantity": 9046,
        "shortParQuantity": 5147,
        "marketCode": "B",
        "tradeReportDate": "2021-05-03",
        "securitiesInformationProcessorSymbolIdentifier": "AA",
        "shortExemptParQuantity": 0
    },
    {
        "reportingFacilityCode": "NQTRF",
        "totalParQuantity": 1376022,
        "shortParQuantity": 786567,
        "marketCode": "Q",
        "tradeReportDate": "2021-05-03",
        "securitiesInformationProcessorSymbolIdentifier": "AA",
        "shortExemptParQuantity": 1885
    },
    {
        "reportingFacilityCode": "NYTRF",
        "totalParQuantity": 411504,
        "shortParQuantity": 214497,
        "marketCode": "N",
        "tradeReportDate": "2021-05-03",
        "securitiesInformationProcessorSymbolIdentifier": "AA",
        "shortExemptParQuantity": 0
    }
]

 

Sample Request
https://api.finra.org/data/group/otcMarket/name/regShoDailyMock

 

Sample Request Payload
{
"limit":5,
"fields":["tradeReportDate","securitiesInformationProcessorSymbolIdentifier","shortParQuantity","shortExemptParQuantity","totalParQuantity"],  
"compareFilters": [ 
{"compareType": "equal", "fieldName": "marketCode", "fieldValue": "Q" }
]
}
 

 

Sample Response
[
    {
        "totalParQuantity": 134248,
        "shortParQuantity": 41895,
        "tradeReportDate": "2021-05-03",
        "securitiesInformationProcessorSymbolIdentifier": "A",
        "shortExemptParQuantity": 1014
    },
    {
        "totalParQuantity": 1376022,
        "shortParQuantity": 786567,
        "tradeReportDate": "2021-05-03",
        "securitiesInformationProcessorSymbolIdentifier": "AA",
        "shortExemptParQuantity": 1885
    },
    {
        "totalParQuantity": 1,
        "shortParQuantity": 1,
        "tradeReportDate": "2021-05-03",
        "securitiesInformationProcessorSymbolIdentifier": "AAA",
        "shortExemptParQuantity": 0
    },
    {
        "totalParQuantity": 33511,
        "shortParQuantity": 11369,
        "tradeReportDate": "2021-05-03",
        "securitiesInformationProcessorSymbolIdentifier": "AAAU",
        "shortExemptParQuantity": 0
    },
    {
        "totalParQuantity": 2119435,
        "shortParQuantity": 473687,
        "tradeReportDate": "2021-05-03",
        "securitiesInformationProcessorSymbolIdentifier": "AAC",
        "shortExemptParQuantity": 0
    }
]

 

Threshold List

OTC Regulation SHO and Rule 4320 Threshold Securities.

Dataset Info:

group dataset test dataset
otcMarket thresholdList thresholdListMock

 

Sample Request
https://api.finra.org/data/group/otcMarket/name/thresholdListMock?limit=5

 

Sample Response
[
    {
        "regShoThresholdFlag": "N",
        "issueSymbolIdentifier": "AACAY",
        "issueName": "AAC Technologies Holdings Inc Unsponsored ADR (Cayman Islands)",
        "thresholdListFlag": "NR",
        "marketCategoryDescription": "Other OTC",
        "rule4320Flag": "Y",
        "tradeDate": "2019-01-14",
        "marketClassCode": "OTC"
    },
    {
        "regShoThresholdFlag": "N",
        "issueSymbolIdentifier": "AHKSY",
        "issueName": "Asahi Kaisai Corporation American Depositary Shares",
        "thresholdListFlag": "NR",
        "marketCategoryDescription": "Other OTC",
        "rule4320Flag": "Y",
        "tradeDate": "2019-01-14",
        "marketClassCode": "OTC"
    },
    {
        "regShoThresholdFlag": "N",
        "issueSymbolIdentifier": "ASGLY",
        "issueName": "AGC Inc. American Depositary Receipts - Unsponsored",
        "thresholdListFlag": "NR",
        "marketCategoryDescription": "Other OTC",
        "rule4320Flag": "Y",
        "tradeDate": "2019-01-14",
        "marketClassCode": "OTC"
    },
    {
        "regShoThresholdFlag": "N",
        "issueSymbolIdentifier": "BKRIY",
        "issueName": "Bank Ireland Group PLC American Depositary Receipts - Unsponsored (Ireland)",
        "thresholdListFlag": "NR",
        "marketCategoryDescription": "Other OTC",
        "rule4320Flag": "Y",
        "tradeDate": "2019-01-14",
        "marketClassCode": "OTC"
    },
    {
        "regShoThresholdFlag": "N",
        "issueSymbolIdentifier": "BNTGY",
        "issueName": "Brenntag AG, Muehleim/Ruhr Unsponsored American Depository Receipt (Germany)",
        "thresholdListFlag": "NR",
        "marketCategoryDescription": "Other OTC",
        "rule4320Flag": "Y",
        "tradeDate": "2019-01-14",
        "marketClassCode": "OTC"
    }
]

 

Sample Request
https://api.finra.org/data/group/otcMarket/name/thresholdListMock

 

Sample Request Payload
{
"limit":5,
"fields":["tradeDate","issueSymbolIdentifier","issueName","marketClassCode","thresholdListFlag","regShoThresholdFlag"],  
"compareFilters": [ 
{"compareType": "equal", "fieldName": "regShoThresholdFlag", "fieldValue": "Y" }
]
}
 

 

Sample Response
[
    {
        "regShoThresholdFlag": "Y",
        "issueSymbolIdentifier": "RYSMF",
        "issueName": "Royal Standard Minerals Inc Ordinary Shares",
        "thresholdListFlag": "R",
        "tradeDate": "2019-01-14",
        "marketClassCode": "OTC"
    },
    {
        "regShoThresholdFlag": "Y",
        "issueSymbolIdentifier": "RYSMF",
        "issueName": "Royal Standard Minerals Inc Ordinary Shares",
        "thresholdListFlag": "R",
        "tradeDate": "2019-01-11",
        "marketClassCode": "OTC"
    },
    {
        "regShoThresholdFlag": "Y",
        "issueSymbolIdentifier": "RYSMF",
        "issueName": "Royal Standard Minerals Inc Ordinary Shares",
        "thresholdListFlag": "R",
        "tradeDate": "2019-01-10",
        "marketClassCode": "OTC"
    },
    {
        "regShoThresholdFlag": "Y",
        "issueSymbolIdentifier": "RYSMF",
        "issueName": "Royal Standard Minerals Inc Ordinary Shares",
        "thresholdListFlag": "R",
        "tradeDate": "2019-01-09",
        "marketClassCode": "OTC"
    },
    {
        "regShoThresholdFlag": "Y",
        "issueSymbolIdentifier": "RYSMF",
        "issueName": "Royal Standard Minerals Inc Ordinary Shares",
        "thresholdListFlag": "R",
        "tradeDate": "2019-01-08",
        "marketClassCode": "OTC"
    }
]

 

Weekly Summary

Weekly aggregate trade data for OTC (ATS and non-ATS) trading data for each ATS/firm with trade reporting obligations under FINRA rules.

Dataset Info:

group dataset test dataset historical dataset
otcMarket weeklySummary weeklySummaryMock weeklySummaryHistoric

 

  1. weeklySummary: The weeklySummary production dataset contains a rolling twelve months of data.
  2. weeklySummaryHistoric: The weeklySummary historic dataset provides a rolling 4 years of data starting with one year prior to the current date.
    •  One (and only one) of the following fields must be used to query the dataset:
      • weekStartDate - a date field in yyyy-MM-dd format that must be a Monday. If a date other than a Monday is provided no data will be returned.
      • historicalWeek - a date field in yyyy-MM-dd format. If a date other than a Monday is provided the platform will calculate the corresponding weekStartDate for the provided date.
      • historicalMonth - a date field in yyyy-MMM format. The platform will provide all data with a weekStartDate within the month provided.
    • The tierIdentifier field can also be used to filter the data.
    • No other fields can be used to filter the data.
    • Sorting is not supported.
    • Data older than one year is static and is not updated. Do not repeatedly download older data looking for updates.
    • Async API request type should be used for weeklySummaryHistoric data if timeout errors occur when retrieving large volumes of data.
Sample Request
https://api.finra.org/data/group/otcMarket/name/weeklysummaryMock?limit=5

 

Sample Response
[
    {
        "totalWeeklyShareQuantity": 186876,
        "issueSymbolIdentifier": "EIDO",
        "issueName": "iShares MSCI Indonesia ETF",
        "lastUpdateDate": "2019-12-16",
        "lastReportedDate": "2019-11-29",
        "tierDescription": "NMS Tier 1",
        "initialPublishedDate": "2019-12-16",
        "tierIdentifier": "T1",
        "summaryStartDate": "2019-11-25",
        "totalWeeklyTradeCount": 1394,
        "weekStartDate": "2019-11-25",
        "MPID": null,
        "firmCRDNumber": null,
        "productTypeCode": "CTS",
        "marketParticipantName": null,
        "summaryTypeCode": "ATS_W_SMBL"
    },
    {
        "totalWeeklyShareQuantity": 117725,
        "issueSymbolIdentifier": "BKU",
        "issueName": "Bankunited, Inc.",
        "lastUpdateDate": "2019-12-16",
        "lastReportedDate": "2019-11-29",
        "tierDescription": "NMS Tier 1",
        "initialPublishedDate": "2019-12-16",
        "tierIdentifier": "T1",
        "summaryStartDate": "2019-11-25",
        "totalWeeklyTradeCount": 1103,
        "weekStartDate": "2019-11-25",
        "MPID": null,
        "firmCRDNumber": null,
        "productTypeCode": "CTS",
        "marketParticipantName": null,
        "summaryTypeCode": "ATS_W_SMBL"
    },
    {
        "totalWeeklyShareQuantity": 3084305,
        "issueSymbolIdentifier": "MO",
        "issueName": "Altria Group, Inc.",
        "lastUpdateDate": "2019-12-16",
        "lastReportedDate": "2019-11-29",
        "tierDescription": "NMS Tier 1",
        "initialPublishedDate": "2019-12-16",
        "tierIdentifier": "T1",
        "summaryStartDate": "2019-11-25",
        "totalWeeklyTradeCount": 20877,
        "weekStartDate": "2019-11-25",
        "MPID": null,
        "firmCRDNumber": null,
        "productTypeCode": "CTS",
        "marketParticipantName": null,
        "summaryTypeCode": "ATS_W_SMBL"
    },
    {
        "totalWeeklyShareQuantity": 920769,
        "issueSymbolIdentifier": "CAT",
        "issueName": "Caterpillar Inc.",
        "lastUpdateDate": "2019-12-16",
        "lastReportedDate": "2019-11-29",
        "tierDescription": "NMS Tier 1",
        "initialPublishedDate": "2019-12-16",
        "tierIdentifier": "T1",
        "summaryStartDate": "2019-11-25",
        "totalWeeklyTradeCount": 8343,
        "weekStartDate": "2019-11-25",
        "MPID": null,
        "firmCRDNumber": null,
        "productTypeCode": "CTS",
        "marketParticipantName": null,
        "summaryTypeCode": "ATS_W_SMBL"
    },
    {
        "totalWeeklyShareQuantity": 443378,
        "issueSymbolIdentifier": "RPM",
        "issueName": "RPM International, Inc.",
        "lastUpdateDate": "2019-12-16",
        "lastReportedDate": "2019-11-29",
        "tierDescription": "NMS Tier 1",
        "initialPublishedDate": "2019-12-16",
        "tierIdentifier": "T1",
        "summaryStartDate": "2019-11-25",
        "totalWeeklyTradeCount": 3637,
        "weekStartDate": "2019-11-25",
        "MPID": null,
        "firmCRDNumber": null,
        "productTypeCode": "CTS",
        "marketParticipantName": null,
        "summaryTypeCode": "ATS_W_SMBL"
    }
]

 

Sample Request
https://api.finra.org/data/group/otcMarket/name/weeklysummaryMock

 

Sample Request Payload
{
"limit":5,
"fields":["issueSymbolIdentifier", "issueName", "totalWeeklyShareQuantity","totalWeeklyTradeCount","lastUpdateDate"],  
"compareFilters": [ 
{  "compareType": "equal", "fieldName": "tierIdentifier", "fieldValue": "T1" },
{  "compareType": "greater", "fieldName": "summaryStartDate", "fieldValue":"2019-09-01"},
{  "compareType": "equal", "fieldName": "summaryTypeCode", "fieldValue": "OTC_W_SMBL" },
{  "compareType": "equal", "fieldName": "issueSymbolIdentifier", "fieldValue" : "AAPL"}
]
}

 

Sample Response
[
    {
        "totalWeeklyShareQuantity": 26751538,
        "totalWeeklyTradeCount": 122064,
        "issueSymbolIdentifier": "AAPL",
        "issueName": "Apple Inc. Common Stock",
        "lastUpdateDate": "2019-12-16"
    },
    {
        "totalWeeklyShareQuantity": 61066753,
        "totalWeeklyTradeCount": 344312,
        "issueSymbolIdentifier": "AAPL",
        "issueName": "Apple Inc. Common Stock",
        "lastUpdateDate": "2020-01-21"
    },
    {
        "totalWeeklyShareQuantity": 38534334,
        "totalWeeklyTradeCount": 194504,
        "issueSymbolIdentifier": "AAPL",
        "issueName": "Apple Inc. Common Stock",
        "lastUpdateDate": "2019-11-19"
    },
    {
        "totalWeeklyShareQuantity": 46491641,
        "totalWeeklyTradeCount": 237714,
        "issueSymbolIdentifier": "AAPL",
        "issueName": "Apple Inc. Common Stock",
        "lastUpdateDate": "2020-01-13"
    },
    {
        "totalWeeklyShareQuantity": 44012751,
        "totalWeeklyTradeCount": 217716,
        "issueSymbolIdentifier": "AAPL",
        "issueName": "Apple Inc. Common Stock",
        "lastUpdateDate": "2019-12-02"
    }
]

 


 

FINRA Content

Datasets in the FINRA Content category include data and content typically found on FINRA.org including the FINRA Rulebook.

See the available datasets below.

 

FINRA Rulebook

FINRA's current and historical rules and regulations

Dataset Info:

group dataset test dataset
finra finraRulebook finraRulebookMock

 

Sample Request
https://api.finra.org/data/group/finra/name/finraRulebookMock?limit=2

 

Sample Response
[
    {
        "effectiveEndDate": "2017-04-02",
        "ruleNumber": "14100",
        "effectiveStartDate": "2015-12-20",
        "ruleTextAscii": "Past version: effective from Dec 20, 2015 - Apr 02, 2017. To view other versions open the versions dropdown on the right.    Unless otherwise defined in the Code, terms used in the Code and interpretive material, if defined in the FINRA By-Laws, shall have the meaning as defined in the FINRA By-Laws.     (a) Board     The term \"Board\" means the Board of Directors of FINRA Regulation, Inc.     (b) Code     The term \"Code\" means the Code of Mediation Procedure.     (c) Director     The term \"Director\" in the Rule 14000 Series refers to the Director of Mediation at the Office of Dispute Resolution. Unless the Code or any other FINRA rule provides otherwise, the term includes FINRA staff to whom the Director of Mediation has delegated authority.     (d) Matter     The term \"matter\" means a dispute, claim, or controversy.     (e) NAMC     The term \"NAMC\" means the National Arbitration and Mediation Committee of the Board.     (f) FINRA     Unless the Code specifies otherwise, the term \"FINRA\" includes FINRA, Inc., and FINRA Regulation, Inc.     (g) FINRA Customer Code     The term \"Customer Code\" means the Code of Arbitration Procedure for Customer Disputes.     (h) FINRA Industry Code     The term \"Industry Code\" means the Code of Arbitration Procedure for Industry Disputes.     (i) Submission Agreement     The term \"Submission Agreement\" means the FINRA Mediation Submission Agreement. The FINRA Mediation Submission Agreement is a document that parties must sign at the outset of a mediation in which they agree to submit to mediation under the Code.         Amended by SR-FINRA-2015-034 eff. Dec. 20, 2015.       Amended by SR-FINRA-2008-021 eff. Dec. 15, 2008.       Renumbered from Rule 10401 and amended by SR-NASD-2007-022 eff. April 16, 2007.       Adopted by SR-NASD-2004-013 eff. Jan. 30, 2006.Selected Notices: 05-85, 08-57, 16-04.        ",
        "ruleTextHtml": "Past version: effective from Dec 20, 2015 - Apr 02, 2017. To view other versions open the versions dropdown on the right. <div class=\"indent_firstpara\">   Unless otherwise defined in the Code, terms used in the Code and interpretive material, if defined in the FINRA By-Laws, shall have the meaning as defined in the FINRA By-Laws. </div> <div class=\"indent_firstpara\">   <strong>(a) Board</strong> </div> <div class=\"indent_firstpara\">   The term \"Board\" means the Board of Directors of FINRA <span class=\"us\">Regulation</span>, Inc. </div> <div class=\"indent_firstpara\">   <strong>(b) Code</strong> </div> <div class=\"indent_firstpara\">   The term \"Code\" means the Code of Mediation Procedure. </div> <div class=\"indent_firstpara\">   <strong>(c) Director</strong> </div> <div class=\"indent_firstpara\">   The term \"Director\" in the <ref>Rule 14000</ref> Series refers to the Director of Mediation at <span class=\"us\">the Office of</span> Dispute Resolution. Unless the Code or any other FINRA rule provides otherwise, the term includes FINRA staff to whom the Director of Mediation has delegated authority. </div> <div class=\"indent_firstpara\">   <strong>(d) Matter</strong> </div> <div class=\"indent_firstpara\">   The term \"matter\" means a dispute, claim, or controversy. </div> <div class=\"indent_firstpara\">   <strong>(e) NAMC</strong> </div> <div class=\"indent_firstpara\">   The term \"NAMC\" means the National Arbitration and Mediation Committee of the Board. </div> <div class=\"indent_firstpara\">   <strong>(f) FINRA</strong> </div> <div class=\"indent_firstpara\">   Unless the Code specifies otherwise, the term \"FINRA\" includes FINRA<span class=\"us\">, Inc.</span>, and FINRA <span class=\"us\">Regulation</span>, Inc. </div> <div class=\"indent_firstpara\">   <strong>(g) FINRA Customer Code</strong> </div> <div class=\"indent_firstpara\">   The term \"Customer Code\" means the Code of Arbitration Procedure for Customer Disputes. </div> <div class=\"indent_firstpara\">   <strong>(h) FINRA Industry Code</strong> </div> <div class=\"indent_firstpara\">   The term \"Industry Code\" means the Code of Arbitration Procedure for Industry Disputes. </div> <div class=\"indent_firstpara\">   <strong>(i) Submission Agreement</strong> </div> <div class=\"indent_firstpara\">   The term \"Submission Agreement\" means the FINRA Mediation Submission Agreement. The FINRA Mediation Submission Agreement is a document that parties must sign at the outset of a mediation in which they agree to submit to mediation under the Code. </div> <table width=\"500\" border=\"1\" cellspacing=\"0\" cellpadding=\"4\" class=\"footnote\" bordercolor=\"#D9E3FF\">   <tr>     <td align=\"left\" valign=\"top\">       Amended by SR-FINRA-2015-034 eff. Dec. 20, 2015.<br />       Amended by SR-FINRA-2008-021 eff. Dec. 15, 2008.<br />       Renumbered from Rule 10401 and amended by SR-NASD-2007-022 eff. April 16, 2007.<br />       Adopted by SR-NASD-2004-013 eff. Jan. 30, 2006.<br />       <br />       <strong>Selected Notices:</strong> <ref>05-85</ref>, <ref>08-57</ref>, <ref>16-04</ref>.     </td>   </tr> </table>"
    },
    {
        "effectiveEndDate": "2017-04-02",
        "ruleNumber": "13701",
        "effectiveStartDate": "2015-12-20",
        "ruleTextAscii": "Past version: effective from Dec 20, 2015 - Apr 02, 2017. To view other versions open the versions dropdown on the right.    (a) Parties to an arbitration may agree to settle their dispute at any time. Parties who settle must notify the Director. The Director will continue to administer the arbitration, and fees may continue to accrue, until the Director receives written notice of the settlement. The parties do not need to disclose the terms of the settlement agreement to the Director or to the Office of Dispute Resolution, but members and associated persons may have reporting obligations under the rules of FINRA.     (b) Settling parties will remain responsible for fees incurred under the Code. If parties to a settlement fail to agree on the allocation of any outstanding fees, those fees will be divided equally among the settling parties, except member surcharges and prehearing and hearing process fees required by the Code, which will remain the responsibility of the member party or parties.         Amended by SR-FINRA-2015-034 eff. Dec. 20, 2015.       Amended by SR-FINRA-2008-021 eff. Dec. 15, 2008.       Adopted by SR-NASD-2004-011 eff. April 16, 2007.Selected Notice: 07-07, 08-57, 16-04.        ",
        "ruleTextHtml": "Past version: effective from Dec 20, 2015 - Apr 02, 2017. To view other versions open the versions dropdown on the right. <div class=\"indent_firstpara\">   (a) Parties to an arbitration may agree to settle their dispute at any time. Parties who settle must notify the Director. The Director will continue to administer the arbitration, and fees may continue to accrue, until the Director receives written notice of the settlement. The parties do not need to disclose the terms of the settlement agreement to the Director or to <span class=\"us\">the Office of</span> Dispute Resolution, but members and associated persons may have reporting obligations under the rules of FINRA. </div> <div class=\"indent_firstpara\">   (b) Settling parties will remain responsible for fees incurred under the Code. If parties to a settlement fail to agree on the allocation of any outstanding fees, those fees will be divided equally among the settling parties, except member surcharges and prehearing and hearing process fees required by the Code, which will remain the responsibility of the member party or parties. </div> <table width=\"500\" border=\"1\" cellspacing=\"0\" cellpadding=\"4\" class=\"footnote\" bordercolor=\"#D9E3FF\">   <tr>     <td align=\"left\" valign=\"top\">       Amended by SR-FINRA-2015-034 eff. Dec. 20, 2015.<br />       Amended by SR-FINRA-2008-021 eff. Dec. 15, 2008.<br />       Adopted by SR-NASD-2004-011 eff. April 16, 2007.<br />       <br />       <strong>Selected Notice:</strong> <ref>07-07</ref>, <ref>08-57</ref>, <ref>16-04</ref>.     </td>   </tr> </table>"
    }
]

 

Sample Request
https://api.finra.org/data/group/finra/name/finraRulebookMock

 

Sample Request Payload
{
"limit":5,
"fields":["effectiveStartDate","effectiveEndDate","ruleTextAscii"],  
"compareFilters": [ 
{"compareType": "equal", "fieldName": "ruleNumber", "fieldValue": "13701" }
]
}
 

 

Sample Response
[
    {
        "effectiveEndDate": "2017-04-02",
        "effectiveStartDate": "2015-12-20",
        "ruleTextAscii": "Past version: effective from Dec 20, 2015 - Apr 02, 2017. To view other versions open the versions dropdown on the right.    (a) Parties to an arbitration may agree to settle their dispute at any time. Parties who settle must notify the Director. The Director will continue to administer the arbitration, and fees may continue to accrue, until the Director receives written notice of the settlement. The parties do not need to disclose the terms of the settlement agreement to the Director or to the Office of Dispute Resolution, but members and associated persons may have reporting obligations under the rules of FINRA.     (b) Settling parties will remain responsible for fees incurred under the Code. If parties to a settlement fail to agree on the allocation of any outstanding fees, those fees will be divided equally among the settling parties, except member surcharges and prehearing and hearing process fees required by the Code, which will remain the responsibility of the member party or parties.         Amended by SR-FINRA-2015-034 eff. Dec. 20, 2015.       Amended by SR-FINRA-2008-021 eff. Dec. 15, 2008.       Adopted by SR-NASD-2004-011 eff. April 16, 2007.Selected Notice: 07-07, 08-57, 16-04.        "
    }
]

 


 

Firm

The Firm API datasets provide access to data specific to individual FINRA member firms.

See the available datasets below. 

 

4530 Customer Complaints

4530 customer complaint filings submitted by your firm.

Dataset Info:

group dataset test dataset
firm 4530filings 4530filingsMock

 

Sample Request
https://api.finra.org/data/group/firm/name/4530filingsMock?limit=5

 

Sample Response
[
    {
        "branchStateCode": "CA",
        "contactFirstName": "Alex",
        "securityDescription3": "The only danger Im in is financial crisis.",
        "securityDescription2": "That one way to find out your financial status",
        "securityDescription1": "British Special Operations Executive (SOE) to communicate with their agents",
        "explanation": "British Special Operations Executive (SOE) to communicate with their agents",
        "representativeEmploymentStateCode": "Y",
        "problemCode": "63",
        "investigatorLastName": "Lauren",
        "statutoryDisqualificationPartyLastName": "Haro",
        "filingPeriod": "2019Q2",
        "securitySymbol2": "QWQWQW",
        "securitySymbol3": "UYUYU",
        "securitySymbol1": "ZZZ",
        "branchCrdNumber": "0101010000",
        "filingNumber": 1,
        "allegedActivityPeriodDateFlag1": "N",
        "allegedActivityPeriodDateFlag2": "N",
        "complaintRelatedToFirmFlag": "1",
        "discoveryDate": "2019-01-22 00:00:00.0",
        "filingStatus": "S",
        "representativeSupervisorFirstName": "Ashrook",
        "contactTelephoneNumber": "000-000-1234",
        "branchPostalCode": "20878",
        "customerFirstName": "Donna",
        "complaintRelatedToRepresentativeFlag": "0",
        "contactLastName": "Posin",
        "disputedAmountIndicator": "0",
        "totalDisputedAmount": 58383,
        "statutoryDisqualificationPartyCompanyName": "XYZ Company",
        "complaintRelatedToAccountsPayableFlag": "1",
        "commentSummary": "Close the window airforce is coming",
        "disciplinaryActionCode": "W",
        "dispositionCode": "A",
        "responseDate": "2019-03-04 12:11:29.0",
        "statutoryDisqualificationPartyFirstName": "Jess",
        "allegedActivityPeriodDate2": "2019/00/00",
        "transactionDate2": "2019-01-01 00:00:00.0",
        "filingTypeCode": "C",
        "allegedActivityPeriodDate1": "2019/00/00",
        "transactionAmount": 111326,
        "representativeCity": "Orefield",
        "customerLastName": "Samueal",
        "representativeCrdNumber": 1245675444,
        "subjectsName": "Adam Cuce",
        "complaintRelatedToMunicipalFlag": "1",
        "submissionDate": "2019-04-04 16:24:29.0",
        "firmCrdNumber": 76543210,
        "transactionDate": "2019-01-01 00:00:00.0",
        "investigatorFirstName": "RALPH",
        "versionNumber": 1,
        "eventCode": "19",
        "productCode": "00",
        "statutoryDisqualificationsMemberRelationCode": "A ",
        "firmSequenceNumber": "123",
        "complaintRelatedToAffiliateFlag": "0",
        "complaintRelatedToOtherFlag": "1",
        "comment": "The client has no problem",
        "representativeSupervisorLastName": "sussilk",
        "representativeZipCodeNumber": 20878,
        "otherPartyName": "Siddset"
    },
    {
        "branchStateCode": "MD",
        "contactFirstName": "Ismael",
        "securityDescription3": "The only danger Im in is financial crisis. ",
        "securityDescription2": "That one way to find out your financial status",
        "securityDescription1": "British Special Operations Executive (SOE) to communicate with their agents",
        "explanation": "British Special Operations Executive (SOE) to communicate with their agents",
        "representativeEmploymentStateCode": "Y",
        "problemCode": "60",
        "investigatorLastName": "Repa",
        "statutoryDisqualificationPartyLastName": "ALOI",
        "filingPeriod": "2010Q2",
        "securitySymbol2": "QWQWQW",
        "securitySymbol3": "UYUYU",
        "securitySymbol1": "ZZZ",
        "branchCrdNumber": "0101010000",
        "filingNumber": 1,
        "allegedActivityPeriodDateFlag1": "N",
        "allegedActivityPeriodDateFlag2": "N",
        "complaintRelatedToFirmFlag": "1",
        "discoveryDate": "2010-01-22 00:00:00.0",
        "filingStatus": "X",
        "representativeSupervisorFirstName": "RAFFAELE",
        "contactTelephoneNumber": "000-000-1234",
        "branchPostalCode": "12345",
        "customerFirstName": "Abby",
        "complaintRelatedToRepresentativeFlag": "1",
        "contactLastName": "Anthony",
        "disputedAmountIndicator": "0",
        "totalDisputedAmount": 39224,
        "statutoryDisqualificationPartyCompanyName": "XYZ Company",
        "complaintRelatedToAccountsPayableFlag": "1",
        "commentSummary": "Close the window airforce is coming",
        "disciplinaryActionCode": "W",
        "dispositionCode": "J",
        "responseDate": "2010-03-04 12:11:29.0",
        "statutoryDisqualificationPartyFirstName": "ANDREW",
        "allegedActivityPeriodDate2": "2010/00/00",
        "transactionDate2": "2010-10-01 00:00:00.0",
        "filingTypeCode": "D",
        "allegedActivityPeriodDate1": "2010/00/00",
        "transactionAmount": 56405,
        "representativeCity": "CUMMING",
        "customerLastName": "Romain",
        "representativeCrdNumber": 1245675444,
        "subjectsName": "ANDERSON, ERIC",
        "complaintRelatedToMunicipalFlag": "1",
        "submissionDate": "2010-02-04 16:24:29.0",
        "firmCrdNumber": 76543210,
        "transactionDate": "2010-01-01 00:00:00.0",
        "investigatorFirstName": "Belle",
        "versionNumber": 12,
        "eventCode": "18",
        "productCode": "01",
        "statutoryDisqualificationsMemberRelationCode": "F ",
        "firmSequenceNumber": "123",
        "complaintRelatedToAffiliateFlag": "0",
        "complaintRelatedToOtherFlag": "1",
        "comment": "The client has no problem",
        "representativeSupervisorLastName": "HOFFMAN",
        "representativeZipCodeNumber": 22180,
        "otherPartyName": "Kaplan, Robert"
    },
    {
        "branchStateCode": "VA",
        "contactFirstName": "Menachem",
        "securityDescription3": "The only danger Im in is financial crisis",
        "securityDescription2": "That one way to find out your financial status",
        "securityDescription1": "British Special Operations Executive (SOE) to communicate with their agents",
        "explanation": "British Special Operations Executive (SOE) to communicate with their agents",
        "representativeEmploymentStateCode": "Y",
        "problemCode": "61",
        "investigatorLastName": "LOKENSKY",
        "statutoryDisqualificationPartyLastName": "Aliaga",
        "filingPeriod": "2011Q2",
        "securitySymbol2": "QWQWQW",
        "securitySymbol3": "UYUYU",
        "securitySymbol1": "ZZZ",
        "branchCrdNumber": "0101010000",
        "filingNumber": 3,
        "allegedActivityPeriodDateFlag1": "Y",
        "allegedActivityPeriodDateFlag2": "Y",
        "complaintRelatedToFirmFlag": "1",
        "discoveryDate": "2011-01-22 00:00:00.0",
        "filingStatus": "D",
        "representativeSupervisorFirstName": "Meisheng",
        "contactTelephoneNumber": "000-000-1234",
        "branchPostalCode": "64333",
        "customerFirstName": "Lacey",
        "complaintRelatedToRepresentativeFlag": "0",
        "contactLastName": "Cruz",
        "disputedAmountIndicator": "0",
        "totalDisputedAmount": 11233,
        "statutoryDisqualificationPartyCompanyName": "XYZ Company",
        "complaintRelatedToAccountsPayableFlag": "1",
        "commentSummary": "Close the window airforce is coming",
        "disciplinaryActionCode": "T",
        "dispositionCode": "S",
        "responseDate": "2011-01-04 12:11:29.0",
        "statutoryDisqualificationPartyFirstName": "Albert",
        "allegedActivityPeriodDate2": "2011/00/00",
        "transactionDate2": "2011-10-01 00:00:00.0",
        "filingTypeCode": "D",
        "allegedActivityPeriodDate1": "2011/00/00",
        "transactionAmount": 8873,
        "representativeCity": "Kennebunk",
        "customerLastName": "ELOSEILY",
        "representativeCrdNumber": 1245675444,
        "subjectsName": "ANDERSON, LINDA",
        "complaintRelatedToMunicipalFlag": "1",
        "submissionDate": "2011-02-20 16:24:29.0",
        "firmCrdNumber": 76543210,
        "transactionDate": "2011-08-01 00:00:00.0",
        "investigatorFirstName": "DANETTE",
        "versionNumber": 3,
        "eventCode": "17",
        "productCode": "02",
        "statutoryDisqualificationsMemberRelationCode": "R ",
        "firmSequenceNumber": "123",
        "complaintRelatedToAffiliateFlag": "1",
        "complaintRelatedToOtherFlag": "1",
        "comment": "The client has no problem",
        "representativeSupervisorLastName": "FRONTERA",
        "representativeZipCodeNumber": 12345,
        "otherPartyName": "Ed Sabo"
    },
    {
        "branchStateCode": "OH",
        "contactFirstName": "Jolyon",
        "securityDescription3": "The only danger Im in is financial crisis",
        "securityDescription2": "That one way to find out your finance",
        "securityDescription1": "British Special Operations Executive (SOE) to communicate with their agents",
        "explanation": "British Special Operations Executive (SOE) to communicate with their agents",
        "representativeEmploymentStateCode": "N",
        "problemCode": "63",
        "investigatorLastName": "Carolyn",
        "statutoryDisqualificationPartyLastName": "Allen",
        "filingPeriod": "2018Q2",
        "securitySymbol2": "QWQWQW",
        "securitySymbol3": "UYUYU",
        "securitySymbol1": "ZZZ",
        "branchCrdNumber": "0101010000",
        "filingNumber": 4,
        "allegedActivityPeriodDateFlag1": "Y",
        "allegedActivityPeriodDateFlag2": "Y",
        "complaintRelatedToFirmFlag": "1",
        "discoveryDate": "2018-11-22 00:00:00.0",
        "filingStatus": "S",
        "representativeSupervisorFirstName": "KNIGHT",
        "contactTelephoneNumber": "000-000-1234",
        "branchPostalCode": "65745",
        "customerFirstName": "Felix",
        "complaintRelatedToRepresentativeFlag": "1",
        "contactLastName": "Melia",
        "disputedAmountIndicator": "1",
        "totalDisputedAmount": 11235,
        "statutoryDisqualificationPartyCompanyName": "XYZ Company",
        "complaintRelatedToAccountsPayableFlag": "1",
        "commentSummary": "Close the window airforce is coming",
        "disciplinaryActionCode": "W",
        "dispositionCode": "A",
        "responseDate": "2018-12-04 12:11:29.0",
        "statutoryDisqualificationPartyFirstName": "Amber",
        "allegedActivityPeriodDate2": "2018/00/00",
        "transactionDate2": "2018-10-01 00:00:00.0",
        "filingTypeCode": "C",
        "allegedActivityPeriodDate1": "2018/00/00",
        "transactionAmount": 322974,
        "representativeCity": "SOUTHWICK",
        "customerLastName": "kaltenbaugh",
        "representativeCrdNumber": 1245675444,
        "subjectsName": "ANDERSON, STEVEN",
        "complaintRelatedToMunicipalFlag": "1",
        "submissionDate": "2018-11-25 16:24:29.0",
        "firmCrdNumber": 76543210,
        "transactionDate": "2018-12-01 00:00:00.0",
        "investigatorFirstName": "Suzannd",
        "versionNumber": 11,
        "eventCode": "16",
        "productCode": "18",
        "statutoryDisqualificationsMemberRelationCode": "O ",
        "firmSequenceNumber": "123",
        "complaintRelatedToAffiliateFlag": "1",
        "complaintRelatedToOtherFlag": "0",
        "comment": "The client has no problem",
        "representativeSupervisorLastName": "SCHIEFFER",
        "representativeZipCodeNumber": 78563,
        "otherPartyName": "james greer"
    },
    {
        "branchStateCode": "CA",
        "contactFirstName": "Talha",
        "securityDescription3": "The only danger Im in is financial situation cant be ignored completely ",
        "securityDescription2": "That one way to find out your financial status",
        "securityDescription1": "British Special Operations Executive (SOE) to communicate with their agents",
        "explanation": "It is not recommended",
        "representativeEmploymentStateCode": "Y",
        "problemCode": "63",
        "investigatorLastName": "Irish",
        "statutoryDisqualificationPartyLastName": "Amanat",
        "filingPeriod": "2016Q4",
        "securitySymbol2": "QWQWQW",
        "securitySymbol3": "QWQWQW",
        "securitySymbol1": "AAAA",
        "branchCrdNumber": "0101010000",
        "filingNumber": 5,
        "allegedActivityPeriodDateFlag1": "Y",
        "allegedActivityPeriodDateFlag2": "N",
        "complaintRelatedToFirmFlag": "1",
        "discoveryDate": "2016-01-22 00:00:00.0",
        "filingStatus": "X",
        "representativeSupervisorFirstName": "STOKES",
        "contactTelephoneNumber": "000-000-1234",
        "branchPostalCode": "98356",
        "customerFirstName": "Lucia",
        "complaintRelatedToRepresentativeFlag": "0",
        "contactLastName": "Orr",
        "disputedAmountIndicator": "2",
        "totalDisputedAmount": 11134,
        "statutoryDisqualificationPartyCompanyName": "XYZ Companye",
        "complaintRelatedToAccountsPayableFlag": "1",
        "commentSummary": "Blue is the definition of purple squared by green",
        "disciplinaryActionCode": "W",
        "dispositionCode": "J",
        "responseDate": "2016-12-04 12:11:29.0",
        "statutoryDisqualificationPartyFirstName": "Andrew",
        "allegedActivityPeriodDate2": "2016/00/00",
        "transactionDate2": "2016-10-01 00:00:00.0",
        "filingTypeCode": "C",
        "allegedActivityPeriodDate1": "2016/00/00",
        "transactionAmount": 322232,
        "representativeCity": "COLLEGEVILLE",
        "customerLastName": "KANE",
        "representativeCrdNumber": 1245675444,
        "subjectsName": "ANDREWS, JASON",
        "complaintRelatedToMunicipalFlag": "1",
        "submissionDate": "2016-06-25 16:24:29.0",
        "firmCrdNumber": 76543210,
        "transactionDate": "2016-09-01 00:00:00.0",
        "investigatorFirstName": "JONES",
        "versionNumber": 12,
        "eventCode": "15",
        "productCode": "17",
        "statutoryDisqualificationsMemberRelationCode": "R ",
        "firmSequenceNumber": " 123",
        "complaintRelatedToAffiliateFlag": "1",
        "complaintRelatedToOtherFlag": "0",
        "comment": "The client has no problem",
        "representativeSupervisorLastName": "Acuff",
        "representativeZipCodeNumber": 20174,
        "otherPartyName": "BAUDENDISTEL, ROBERT"
    }
]

 

Sample Request
https://api.finra.org/data/group/firm/name/4530filingsMock

 

Sample Request Payload
{
"limit":5,
"fields":["filingNumber","versionNumber","filingTypeCode","filingStatus","firmSequenceNumber","explanation"],  
"compareFilters": [ 
{"compareType": "equal", "fieldName": "disciplinaryActionCode", "fieldValue": "W" }
]
}
 

 

Sample Response
[
    {
        "filingNumber": 1,
        "filingStatus": "S",
        "filingTypeCode": "C",
        "firmSequenceNumber": "123",
        "explanation": "British Special Operations Executive (SOE) to communicate with their agents",
        "versionNumber": 1
    },
    {
        "filingNumber": 1,
        "filingStatus": "X",
        "filingTypeCode": "D",
        "firmSequenceNumber": "123",
        "explanation": "British Special Operations Executive (SOE) to communicate with their agents",
        "versionNumber": 12
    },
    {
        "filingNumber": 4,
        "filingStatus": "S",
        "filingTypeCode": "C",
        "firmSequenceNumber": "123",
        "explanation": "British Special Operations Executive (SOE) to communicate with their agents",
        "versionNumber": 11
    },
    {
        "filingNumber": 5,
        "filingStatus": "X",
        "filingTypeCode": "C",
        "firmSequenceNumber": " 123",
        "explanation": "It is not recommended",
        "versionNumber": 12
    },
    {
        "filingNumber": 7,
        "filingStatus": "S",
        "filingTypeCode": "D",
        "firmSequenceNumber": " 454",
        "explanation": "It is not recommended",
        "versionNumber": 14
    }
]

 


 

Fixed Income

The Fixed Income API datasets provide access to OTC secondary market transaction data for fixed income securities as reported to TRACE.

Key highlights:

  1. Weekly Treasury Aggregates - TRACE reported trading volume in US Treasury Securities aggregated weekly by security subtype.
  2. Market Breadth & Sentiment - TRACE fixed income market breadth and sentiment data.
  3. Capped Volume - TRACE structured product and coporate/agency capped volume data.

See the available datasets below.

 

Terms of Service

Access to the Fixed Income datasets are governed by the following specific Terms of Service:

The specific Terms of Service for the Registration datasets are included by reference in the FINRA API Terms of Service.

Agency Debt Market Breadth

Market breadth calculations for Agency debt securities.

Dataset Info:

group dataset test dataset
fixedIncomeMarket agencyMarketBreadth agencyMarketBreadthMock

 

Sample Request
https://api.finra.org/data/group/fixedIncomeMarket/name/agencyMarketBreadthMock?limit=5

 

Sample Response
[
    {
        "declines": 115,
        "totalVolume": 5521.238468,
        "advances": 227,
        "unchanged": 13,
        "totalTrades": 434,
        "tradeReportDate": "2020-03-31",
        "fiftyTwoWeekHigh": 126,
        "productCategory": "all securities",
        "fiftyTwoWeekLow": 15
    },
    {
        "declines": 17,
        "totalVolume": 1161.404774,
        "advances": 31,
        "unchanged": 5,
        "totalTrades": 67,
        "tradeReportDate": "2020-03-31",
        "fiftyTwoWeekHigh": 14,
        "productCategory": "freddie mac",
        "fiftyTwoWeekLow": 6
    },
    {
        "declines": 20,
        "totalVolume": 1513.166915,
        "advances": 45,
        "unchanged": 0,
        "totalTrades": 77,
        "tradeReportDate": "2020-03-31",
        "fiftyTwoWeekHigh": 18,
        "productCategory": "fannie mae",
        "fiftyTwoWeekLow": 2
    },
    {
        "declines": 42,
        "totalVolume": 2058.135606,
        "advances": 69,
        "unchanged": 2,
        "totalTrades": 128,
        "tradeReportDate": "2020-03-31",
        "fiftyTwoWeekHigh": 37,
        "productCategory": "fhlb",
        "fiftyTwoWeekLow": 5
    },
    {
        "declines": 126,
        "totalVolume": 2991.444765,
        "advances": 242,
        "unchanged": 10,
        "totalTrades": 464,
        "tradeReportDate": "2020-03-30",
        "fiftyTwoWeekHigh": 136,
        "productCategory": "all securities",
        "fiftyTwoWeekLow": 20
    }
]

 

Sample Request
https://api.finra.org/data/group/fixedIncomeMarket/name/agencyMarketBreadthMock

 

Sample Request Payload
{
"limit":5,
"fields":["tradeReportDate","productCategory","totalTrades","advances","declines"],  
"compareFilters": [ 
{"compareType": "lesser", "fieldName": "declines", "fieldValue": 50 }
]
}

 

Sample Response
[
    {
        "declines": 17,
        "advances": 31,
        "totalTrades": 67,
        "tradeReportDate": "2020-03-31",
        "productCategory": "freddie mac"
    },
    {
        "declines": 20,
        "advances": 45,
        "totalTrades": 77,
        "tradeReportDate": "2020-03-31",
        "productCategory": "fannie mae"
    },
    {
        "declines": 42,
        "advances": 69,
        "totalTrades": 128,
        "tradeReportDate": "2020-03-31",
        "productCategory": "fhlb"
    },
    {
        "declines": 19,
        "advances": 23,
        "totalTrades": 67,
        "tradeReportDate": "2020-03-30",
        "productCategory": "freddie mac"
    },
    {
        "declines": 25,
        "advances": 39,
        "totalTrades": 75,
        "tradeReportDate": "2020-03-30",
        "productCategory": "fannie mae"
    }
]

 

Agency Debt Market Sentiment

Market sentiment calculations for Agency debt securities.

Dataset Info:

group dataset test dataset
fixedIncomeMarket agencyMarketSentiment agencyMarketSentimentMock

 

Sample Request
https://api.finra.org/data/group/fixedIncomeMarket/name/agencyMarketSentimentMock?limit=5

 

Sample Response
[
    {
        "totalVolume": 5521.23847,
        "totalTransactions": 1872,
        "totalTrades": 434,
        "tradeReportDate": "2020-03-31",
        "tradeType": "all securities",
        "productCategory": "all securities"
    },
    {
        "totalVolume": 1635.70833,
        "totalTransactions": 412,
        "totalTrades": 211,
        "tradeReportDate": "2020-03-31",
        "tradeType": "all securities",
        "productCategory": "customer buy"
    },
    {
        "totalVolume": 2845.65913,
        "totalTransactions": 683,
        "totalTrades": 304,
        "tradeReportDate": "2020-03-31",
        "tradeType": "all securities",
        "productCategory": "customer sell"
    },
    {
        "totalVolume": 26.522,
        "totalTransactions": 14,
        "totalTrades": 10,
        "tradeReportDate": "2020-03-31",
        "tradeType": "all securities",
        "productCategory": "affiliate buy"
    },
    {
        "totalVolume": 0.528,
        "totalTransactions": 2,
        "totalTrades": 2,
        "tradeReportDate": "2020-03-31",
        "tradeType": "all securities",
        "productCategory": "affiliate sell"
    }
]

 

Sample Request
https://api.finra.org/data/group/fixedIncomeMarket/name/agencyMarketSentimentMock

 

Sample Request Payload
{
"limit":5,
"fields":["tradeReportDate","tradeType","productCategory","totalTransactions","totalTrades"],  
"compareFilters": [ 
{"compareType": "greater", "fieldName": "totalTrades", "fieldValue": 300 }
]
}
 

 

Sample Response
[
    {
        "totalTransactions": 1872,
        "totalTrades": 434,
        "tradeReportDate": "2020-03-31",
        "tradeType": "all securities",
        "productCategory": "all securities"
    },
    {
        "totalTransactions": 683,
        "totalTrades": 304,
        "tradeReportDate": "2020-03-31",
        "tradeType": "all securities",
        "productCategory": "customer sell"
    },
    {
        "totalTransactions": 1954,
        "totalTrades": 464,
        "tradeReportDate": "2020-03-30",
        "tradeType": "all securities",
        "productCategory": "all securities"
    },
    {
        "totalTransactions": 740,
        "totalTrades": 352,
        "tradeReportDate": "2020-03-30",
        "tradeType": "all securities",
        "productCategory": "customer sell"
    },
    {
        "totalTransactions": 1857,
        "totalTrades": 471,
        "tradeReportDate": "2020-03-27",
        "tradeType": "all securities",
        "productCategory": "all securities"
    }
]

 

Corporate 144A Debt Market Breadth

Market breadth calculations for Rule 144A corporate debt securities.

Dataset Info:

group dataset test dataset
fixedIncomeMarket corporate144AMarketBreadth corporate144AMarketBreadthMock

 

Sample Request
https://api.finra.org/data/group/fixedIncomeMarket/name/corporate144AMarketBreadthMock?limit=5

 

Sample Response
[
    {
        "declines": 592,
        "totalVolume": 11093.5282,
        "advances": 1018,
        "unchanged": 53,
        "totalTrades": 1746,
        "tradeReportDate": "2020-03-31",
        "fiftyTwoWeekHigh": 19,
        "productCategory": "all securities",
        "fiftyTwoWeekLow": 101
    },
    {
        "declines": 165,
        "totalVolume": 3710.398133,
        "advances": 430,
        "unchanged": 19,
        "totalTrades": 661,
        "tradeReportDate": "2020-03-31",
        "fiftyTwoWeekHigh": 14,
        "productCategory": "investment grade",
        "fiftyTwoWeekLow": 32
    },
    {
        "declines": 401,
        "totalVolume": 6847.515149,
        "advances": 551,
        "unchanged": 33,
        "totalTrades": 1020,
        "tradeReportDate": "2020-03-31",
        "fiftyTwoWeekHigh": 5,
        "productCategory": "high yield",
        "fiftyTwoWeekLow": 66
    },
    {
        "declines": 26,
        "totalVolume": 535.92,
        "advances": 37,
        "unchanged": 1,
        "totalTrades": 65,
        "tradeReportDate": "2020-03-31",
        "fiftyTwoWeekHigh": 0,
        "productCategory": "convertibles",
        "fiftyTwoWeekLow": 3
    },
    {
        "declines": 460,
        "totalVolume": 9120.73982,
        "advances": 934,
        "unchanged": 70,
        "totalTrades": 1543,
        "tradeReportDate": "2020-03-30",
        "fiftyTwoWeekHigh": 19,
        "productCategory": "all securities",
        "fiftyTwoWeekLow": 113
    }
]

 

Sample Request
https://api.finra.org/data/group/fixedIncomeMarket/name/corporate144AMarketBreadthMock

 

Sample Request Payload
{
"limit":5,
"fields":["productCategory","fiftyTwoWeekLow","declines","unchanged","totalVolume"],  
"compareFilters": [ 
{"compareType": "greater", "fieldName": "fiftyTwoWeekLow", "fieldValue": 50 }
]
}
 

 

Sample Response
[
    {
        "declines": 592,
        "totalVolume": 11093.5282,
        "unchanged": 53,
        "productCategory": "all securities",
        "fiftyTwoWeekLow": 101
    },
    {
        "declines": 401,
        "totalVolume": 6847.515149,
        "unchanged": 33,
        "productCategory": "high yield",
        "fiftyTwoWeekLow": 66
    },
    {
        "declines": 460,
        "totalVolume": 9120.73982,
        "unchanged": 70,
        "productCategory": "all securities",
        "fiftyTwoWeekLow": 113
    },
    {
        "declines": 298,
        "totalVolume": 5435.334856,
        "unchanged": 40,
        "productCategory": "high yield",
        "fiftyTwoWeekLow": 62
    },
    {
        "declines": 489,
        "totalVolume": 10635.742387,
        "unchanged": 65,
        "productCategory": "all securities",
        "fiftyTwoWeekLow": 126
    }
]

 

Corporate 144A Debt Market Sentiment

Market sentiment calculations for Rule 144A corporate debt securities.

Dataset Info:

group dataset test dataset
fixedIncomeMarket corporate144AMarketSentiment corporate144AMarketSentimentMock

 

Sample Request
https://api.finra.org/data/group/fixedIncomeMarket/name/corporate144AMarketSentimentMock?limit=5

 

Sample Response
[
    {
        "totalVolume": 11193.43528,
        "totalTransactions": 7937,
        "totalTrades": 1754,
        "tradeReportDate": "2020-03-31",
        "tradeType": "all securities",
        "productCategory": "all securities"
    },
    {
        "totalVolume": 4893.34163,
        "totalTransactions": 3124,
        "totalTrades": 1355,
        "tradeReportDate": "2020-03-31",
        "tradeType": "all securities",
        "productCategory": "customer buy"
    },
    {
        "totalVolume": 4574.51531,
        "totalTransactions": 2437,
        "totalTrades": 1147,
        "tradeReportDate": "2020-03-31",
        "tradeType": "all securities",
        "productCategory": "customer sell"
    },
    {
        "totalVolume": 178.928,
        "totalTransactions": 154,
        "totalTrades": 133,
        "tradeReportDate": "2020-03-31",
        "tradeType": "all securities",
        "productCategory": "affiliate buy"
    },
    {
        "totalVolume": 345.381,
        "totalTransactions": 144,
        "totalTrades": 127,
        "tradeReportDate": "2020-03-31",
        "tradeType": "all securities",
        "productCategory": "affiliate sell"
    }
]

 

Sample Request
https://api.finra.org/data/group/fixedIncomeMarket/name/corporate144AMarketSentimentMock

 

Sample Request Payload
{
"limit":5,
"fields":["totalVolume","totalTransactions","totalTrades","tradeReportDate","tradeType"],  
"compareFilters": [ 
{"compareType": "equal", "fieldName": "productCategory", "fieldValue": "affiliate buy" }
]
}
 

 

Sample Response
[
    {
        "totalVolume": 178.928,
        "totalTransactions": 154,
        "totalTrades": 133,
        "tradeReportDate": "2020-03-31",
        "tradeType": "all securities"
    },
    {
        "totalVolume": 68.855,
        "totalTransactions": 72,
        "totalTrades": 63,
        "tradeReportDate": "2020-03-31",
        "tradeType": "investment grade"
    },
    {
        "totalVolume": 109.384,
        "totalTransactions": 81,
        "totalTrades": 69,
        "tradeReportDate": "2020-03-31",
        "tradeType": "high yield"
    },
    {
        "totalVolume": 0.689,
        "totalTransactions": 1,
        "totalTrades": 1,
        "tradeReportDate": "2020-03-31",
        "tradeType": "convertible bonds"
    },
    {
        "totalVolume": 0,
        "totalTransactions": 0,
        "totalTrades": 0,
        "tradeReportDate": "2020-03-31",
        "tradeType": "church bonds"
    }
]

 

Corporate And Agency Capped Volume

Capped volume calculations for corporate and agency debt.

Dataset Info:

group dataset test dataset
fixedIncomeMarket corporatesAndAgenciesCappedVolume corporatesAndAgenciesCappedVolumeMock

 

Sample Request
https://api.finra.org/data/group/fixedIncomeMarket/name/corporatesAndAgenciesCappedVolumeMock?limit=5

 

Sample Response
[
    {
        "parMaturityGreaterThan25YearsQuantity": 43804286000,
        "customerBuyParGreaterThan5YearsLessThan10YearsQuantity": 26402324801.22,
        "tradeLessThan5MillionCount": 0,
        "interdealerParGreaterThan10yCountearsLessThan25YearsQuantity": 2036754000,
        "interdealerTradeMaturityGreaterThan25YearsCount": 392,
        "tradeMaturityGreaterThan10YearsLessThan25YearsCount": 2705,
        "interdealerParLessThan5yearsQuantity": 6791411000,
        "interdealerTradeMaturityGreaterThan5yearsLessThan10YearsCount": 612,
        "customerBuyTradeMaturityLessThan5YearsCount": 2953,
        "parGreaterThan10MillionLessThan25MillionQuantity": 117561509467.43,
        "parMaturityGreaterThan10YearsLessThan25YearsQuantity": 29060132844.95,
        "customerSellTradeMaturityGreaterThan25YearsCount": 1811,
        "parMaturityGreaterThan5YearsLessThan10YearsQuantity": 66676020980.07,
        "customerSellTradeMaturityGreaterThan5YearsLessThan10YearsCount": 3014,
        "tradeGreaterThan25MillionCount": 1120,
        "interdealerParGreaterThan25YearsQuantity": 3399482000,
        "parLessThan5MillionQuantity": 0,
        "interdealerMaturityTradeLessThan5yearsCount": 689,
        "customerSellParGreaterThan10YearsLessThan25YearsQuantity": 13177509048.28,
        "tradeReportDate": "2020-07-01",
        "tradeGreaterThan5MillionLessThan10MillionCount": 9661,
        "customerBuyTradeMaturityGreaterThan10YearsLessThan25YearsCount": 1282,
        "customerBuyParGreaterThan25YearsQuantity": 20373951000,
        "interdealerParGreaterThan5yearsLessThan10YearsQuantity": 5328053617.65,
        "customerSellTradeMaturityGreaterThan10YearsLessThan25YearsCount": 1184,
        "tradeYear": 2020,
        "customerSellParGreaterThan25YearsQuantity": 20030853000,
        "tradeGreaterThan10MillionLessThan25MillionCount": 9018,
        "tradeMaturityLessThan5YearsCount": 6974,
        "customerBuyParLessThan5YearsQuantity": 35315591685.65,
        "parGreaterThan25MillionQuantity": 40002509798.63,
        "tradeMonth": 6,
        "customerSellParLessThan5YearsQuantity": 42842671816.48,
        "tradeMaturityGreaterThan25YearsCount": 4083,
        "144AFlag": "N",
        "parMaturityLessThan5YearsQuantity": 84949674502.13,
        "customerBuyTradeMaturityGreaterThan5YearsLessThan10YearsCount": 2411,
        "parGreaterThan5MillionLessThan10MillionQuantity": 66926095061.09,
        "customerSellParGreaterThan5YearsLessThan10YearsQuantity": 34945642561.2,
        "customerBuyTradeMaturityGreaterThan25YearsCount": 1880,
        "tradeMaturityGreaterThan5YearsLessThan10YearsCount": 6037,
        "gradeCode": "IG",
        "customerSellTradeMaturityLessThan5YearsCount": 3332,
        "interdealerTradeMaturityGreaterThan10yearsLessThan25YearsCount": 239,
        "totalTradeCount": 19799,
        "totalVolumeQuantity": 224490114.33,
        "customerBuyParGreaterThan10YearsLessThan25YearsQuantity": 13845869796.67
    },
    {
        "parMaturityGreaterThan25YearsQuantity": 3741177794.94,
        "customerBuyParGreaterThan5YearsLessThan10YearsQuantity": 5298976836.63,
        "tradeLessThan5MillionCount": 0,
        "interdealerParGreaterThan10yCountearsLessThan25YearsQuantity": 351590000,
        "interdealerTradeMaturityGreaterThan25YearsCount": 34,
        "tradeMaturityGreaterThan10YearsLessThan25YearsCount": 428,
        "interdealerParLessThan5yearsQuantity": 1010591000,
        "interdealerTradeMaturityGreaterThan5yearsLessThan10YearsCount": 75,
        "customerBuyTradeMaturityLessThan5YearsCount": 865,
        "parGreaterThan10MillionLessThan25MillionQuantity": 20736632000,
        "parMaturityGreaterThan10YearsLessThan25YearsQuantity": 4689981552.37,
        "customerSellTradeMaturityGreaterThan25YearsCount": 165,
        "parMaturityGreaterThan5YearsLessThan10YearsQuantity": 11449094678.53,
        "customerSellTradeMaturityGreaterThan5YearsLessThan10YearsCount": 491,
        "tradeGreaterThan25MillionCount": 271,
        "interdealerParGreaterThan25YearsQuantity": 309803000,
        "parLessThan5MillionQuantity": 0,
        "interdealerMaturityTradeLessThan5yearsCount": 101,
        "customerSellParGreaterThan10YearsLessThan25YearsQuantity": 2264808872.31,
        "tradeReportDate": "2020-07-01",
        "tradeGreaterThan5MillionLessThan10MillionCount": 1832,
        "customerBuyTradeMaturityGreaterThan10YearsLessThan25YearsCount": 189,
        "customerBuyParGreaterThan25YearsQuantity": 1660881000,
        "interdealerParGreaterThan5yearsLessThan10YearsQuantity": 640368000,
        "customerSellTradeMaturityGreaterThan10YearsLessThan25YearsCount": 198,
        "tradeYear": 2020,
        "customerSellParGreaterThan25YearsQuantity": 1770493794.94,
        "tradeGreaterThan10MillionLessThan25MillionCount": 1590,
        "tradeMaturityLessThan5YearsCount": 1840,
        "customerBuyParLessThan5YearsQuantity": 12699406000,
        "parGreaterThan25MillionQuantity": 13059048000,
        "tradeMonth": 6,
        "customerSellParLessThan5YearsQuantity": 12976067000,
        "tradeMaturityGreaterThan25YearsCount": 360,
        "144AFlag": "Y",
        "parMaturityLessThan5YearsQuantity": 26686064000,
        "customerBuyTradeMaturityGreaterThan5YearsLessThan10YearsCount": 499,
        "parGreaterThan5MillionLessThan10MillionQuantity": 12770638025.84,
        "customerSellParGreaterThan5YearsLessThan10YearsQuantity": 5509749841.9,
        "customerBuyTradeMaturityGreaterThan25YearsCount": 161,
        "tradeMaturityGreaterThan5YearsLessThan10YearsCount": 1065,
        "gradeCode": "IG",
        "customerSellTradeMaturityLessThan5YearsCount": 874,
        "interdealerTradeMaturityGreaterThan10yearsLessThan25YearsCount": 41,
        "totalTradeCount": 3693,
        "totalVolumeQuantity": 46566318.03,
        "customerBuyParGreaterThan10YearsLessThan25YearsQuantity": 2073582680.06
    },
    {
        "parMaturityGreaterThan25YearsQuantity": 20878434182.92,
        "customerBuyParGreaterThan5YearsLessThan10YearsQuantity": 18205801651.04,
        "tradeLessThan5MillionCount": 29069,
        "interdealerParGreaterThan10yCountearsLessThan25YearsQuantity": 3639537365.17,
        "interdealerTradeMaturityGreaterThan25YearsCount": 1119,
        "tradeMaturityGreaterThan10YearsLessThan25YearsCount": 5332,
        "interdealerParLessThan5yearsQuantity": 6687933146.79,
        "interdealerTradeMaturityGreaterThan5yearsLessThan10YearsCount": 2743,
        "customerBuyTradeMaturityLessThan5YearsCount": 5446,
        "parGreaterThan10MillionLessThan25MillionQuantity": 25715408879.37,
        "parMaturityGreaterThan10YearsLessThan25YearsQuantity": 21190653051.67,
        "customerSellTradeMaturityGreaterThan25YearsCount": 2178,
        "parMaturityGreaterThan5YearsLessThan10YearsQuantity": 45325772157.94,
        "customerSellTradeMaturityGreaterThan5YearsLessThan10YearsCount": 5516,
        "tradeGreaterThan25MillionCount": 207,
        "interdealerParGreaterThan25YearsQuantity": 3267701000,
        "parLessThan5MillionQuantity": 66018073172.4,
        "interdealerMaturityTradeLessThan5yearsCount": 2721,
        "customerSellParGreaterThan10YearsLessThan25YearsQuantity": 9092144039.55,
        "tradeReportDate": "2020-07-01",
        "tradeGreaterThan5MillionLessThan10MillionCount": 6376,
        "customerBuyTradeMaturityGreaterThan10YearsLessThan25YearsCount": 1897,
        "customerBuyParGreaterThan25YearsQuantity": 8459478631.46,
        "interdealerParGreaterThan5yearsLessThan10YearsQuantity": 7003842304.8,
        "customerSellTradeMaturityGreaterThan10YearsLessThan25YearsCount": 2205,
        "tradeYear": 2020,
        "customerSellParGreaterThan25YearsQuantity": 9151254551.46,
        "tradeGreaterThan10MillionLessThan25MillionCount": 2013,
        "tradeMaturityLessThan5YearsCount": 13861,
        "customerBuyParLessThan5YearsQuantity": 20695515479.28,
        "parGreaterThan25MillionQuantity": 7669944261.03,
        "tradeMonth": 6,
        "customerSellParLessThan5YearsQuantity": 22107966891.82,
        "tradeMaturityGreaterThan25YearsCount": 5193,
        "144AFlag": "N",
        "parMaturityLessThan5YearsQuantity": 49491415517.89,
        "customerBuyTradeMaturityGreaterThan5YearsLessThan10YearsCount": 5020,
        "parGreaterThan5MillionLessThan10MillionQuantity": 37482848597.62,
        "customerSellParGreaterThan5YearsLessThan10YearsQuantity": 20116128202.1,
        "customerBuyTradeMaturityGreaterThan25YearsCount": 1896,
        "tradeMaturityGreaterThan5YearsLessThan10YearsCount": 13279,
        "gradeCode": "HY",
        "customerSellTradeMaturityLessThan5YearsCount": 5694,
        "interdealerTradeMaturityGreaterThan10yearsLessThan25YearsCount": 1230,
        "totalTradeCount": 37665,
        "totalVolumeQuantity": 136886274.91,
        "customerBuyParGreaterThan10YearsLessThan25YearsQuantity": 8458971646.95
    },
    {
        "parMaturityGreaterThan25YearsQuantity": 3362489424.78,
        "customerBuyParGreaterThan5YearsLessThan10YearsQuantity": 27952177472.96,
        "tradeLessThan5MillionCount": 28241,
        "interdealerParGreaterThan10yCountearsLessThan25YearsQuantity": 1843668218.5,
        "interdealerTradeMaturityGreaterThan25YearsCount": 89,
        "tradeMaturityGreaterThan10YearsLessThan25YearsCount": 2725,
        "interdealerParLessThan5yearsQuantity": 3848546773.45,
        "interdealerTradeMaturityGreaterThan5yearsLessThan10YearsCount": 3642,
        "customerBuyTradeMaturityLessThan5YearsCount": 4731,
        "parGreaterThan10MillionLessThan25MillionQuantity": 19224338889.17,
        "parMaturityGreaterThan10YearsLessThan25YearsQuantity": 10001594259.06,
        "customerSellTradeMaturityGreaterThan25YearsCount": 368,
        "parMaturityGreaterThan5YearsLessThan10YearsQuantity": 67516167607.56,
        "customerSellTradeMaturityGreaterThan5YearsLessThan10YearsCount": 9057,
        "tradeGreaterThan25MillionCount": 116,
        "interdealerParGreaterThan25YearsQuantity": 358367000,
        "parLessThan5MillionQuantity": 64315954799.58,
        "interdealerMaturityTradeLessThan5yearsCount": 1611,
        "customerSellParGreaterThan10YearsLessThan25YearsQuantity": 4254535703.08,
        "tradeReportDate": "2020-07-01",
        "tradeGreaterThan5MillionLessThan10MillionCount": 5568,
        "customerBuyTradeMaturityGreaterThan10YearsLessThan25YearsCount": 954,
        "customerBuyParGreaterThan25YearsQuantity": 1386356000,
        "interdealerParGreaterThan5yearsLessThan10YearsQuantity": 8657287213.67,
        "customerSellTradeMaturityGreaterThan10YearsLessThan25YearsCount": 1073,
        "tradeYear": 2020,
        "customerSellParGreaterThan25YearsQuantity": 1617766424.78,
        "tradeGreaterThan10MillionLessThan25MillionCount": 1515,
        "tradeMaturityLessThan5YearsCount": 11029,
        "customerBuyParLessThan5YearsQuantity": 18089793419.85,
        "parGreaterThan25MillionQuantity": 4813666566,
        "tradeMonth": 6,
        "customerSellParLessThan5YearsQuantity": 18295135468.17,
        "tradeMaturityGreaterThan25YearsCount": 758,
        "144AFlag": "Y",
        "parMaturityLessThan5YearsQuantity": 40233475661.47,
        "customerBuyTradeMaturityGreaterThan5YearsLessThan10YearsCount": 8229,
        "parGreaterThan5MillionLessThan10MillionQuantity": 32759766698.12,
        "customerSellParGreaterThan5YearsLessThan10YearsQuantity": 30906702920.93,
        "customerBuyTradeMaturityGreaterThan25YearsCount": 301,
        "tradeMaturityGreaterThan5YearsLessThan10YearsCount": 20928,
        "gradeCode": "HY",
        "customerSellTradeMaturityLessThan5YearsCount": 4687,
        "interdealerTradeMaturityGreaterThan10yearsLessThan25YearsCount": 698,
        "totalTradeCount": 35440,
        "totalVolumeQuantity": 121113726.95,
        "customerBuyParGreaterThan10YearsLessThan25YearsQuantity": 3903390337.48
    },
    {
        "parMaturityGreaterThan25YearsQuantity": 239442820,
        "customerBuyParGreaterThan5YearsLessThan10YearsQuantity": 7231862337.76,
        "tradeLessThan5MillionCount": 0,
        "interdealerParGreaterThan10yCountearsLessThan25YearsQuantity": 1144701000,
        "interdealerTradeMaturityGreaterThan25YearsCount": 0,
        "tradeMaturityGreaterThan10YearsLessThan25YearsCount": 280,
        "interdealerParLessThan5yearsQuantity": 13186342000,
        "interdealerTradeMaturityGreaterThan5yearsLessThan10YearsCount": 237,
        "customerBuyTradeMaturityLessThan5YearsCount": 1423,
        "parGreaterThan10MillionLessThan25MillionQuantity": 24462156940.22,
        "parMaturityGreaterThan10YearsLessThan25YearsQuantity": 4126340808.62,
        "customerSellTradeMaturityGreaterThan25YearsCount": 7,
        "parMaturityGreaterThan5YearsLessThan10YearsQuantity": 12666687208.82,
        "customerSellTradeMaturityGreaterThan5YearsLessThan10YearsCount": 138,
        "tradeGreaterThan25MillionCount": 883,
        "interdealerParGreaterThan25YearsQuantity": 0,
        "parLessThan5MillionQuantity": 0,
        "interdealerMaturityTradeLessThan5yearsCount": 803,
        "customerSellParGreaterThan10YearsLessThan25YearsQuantity": 866309429.64,
        "tradeReportDate": "2020-07-01",
        "tradeGreaterThan5MillionLessThan10MillionCount": 1007,
        "customerBuyTradeMaturityGreaterThan10YearsLessThan25YearsCount": 131,
        "customerBuyParGreaterThan25YearsQuantity": 160442820,
        "interdealerParGreaterThan5yearsLessThan10YearsQuantity": 3108391000,
        "customerSellTradeMaturityGreaterThan10YearsLessThan25YearsCount": 58,
        "tradeYear": 2020,
        "customerSellParGreaterThan25YearsQuantity": 79000000,
        "tradeGreaterThan10MillionLessThan25MillionCount": 1783,
        "tradeMaturityLessThan5YearsCount": 2585,
        "customerBuyParLessThan5YearsQuantity": 49894795497.36,
        "parGreaterThan25MillionQuantity": 69453789000,
        "tradeMonth": 6,
        "customerSellParLessThan5YearsQuantity": 20991290203.47,
        "tradeMaturityGreaterThan25YearsCount": 19,
        "144AFlag": "N",
        "parMaturityLessThan5YearsQuantity": 84072427700.83,
        "customerBuyTradeMaturityGreaterThan5YearsLessThan10YearsCount": 414,
        "parGreaterThan5MillionLessThan10MillionQuantity": 7188952598.05,
        "customerSellParGreaterThan5YearsLessThan10YearsQuantity": 2326433871.06,
        "customerBuyTradeMaturityGreaterThan25YearsCount": 12,
        "tradeMaturityGreaterThan5YearsLessThan10YearsCount": 789,
        "gradeCode": "AGCY",
        "customerSellTradeMaturityLessThan5YearsCount": 359,
        "interdealerTradeMaturityGreaterThan10yearsLessThan25YearsCount": 91,
        "totalTradeCount": 3673,
        "totalVolumeQuantity": 101104898.54,
        "customerBuyParGreaterThan10YearsLessThan25YearsQuantity": 2115330378.98
    }
]

 

Sample Request
https://api.finra.org/data/group/fixedIncomeMarket/name/corporatesAndAgenciesCappedVolumeMock

 

Sample Request Payload
{
"limit":5,
"fields":["tradeReportDate","tradeMonth","tradeYear","gradeCode","totalTradeCount"],  
"compareFilters": [ 
{"compareType": "equal", "fieldName": "144AFlag", "fieldValue": "N" }
]
}
 

 

Sample Response
[
    {
        "tradeMonth": 6,
        "tradeYear": 2020,
        "tradeReportDate": "2020-07-01",
        "gradeCode": "IG",
        "totalTradeCount": 19799
    },
    {
        "tradeMonth": 6,
        "tradeYear": 2020,
        "tradeReportDate": "2020-07-01",
        "gradeCode": "HY",
        "totalTradeCount": 37665
    },
    {
        "tradeMonth": 6,
        "tradeYear": 2020,
        "tradeReportDate": "2020-07-01",
        "gradeCode": "AGCY",
        "totalTradeCount": 3673
    },
    {
        "tradeMonth": 5,
        "tradeYear": 2020,
        "tradeReportDate": "2020-07-01",
        "gradeCode": "IG",
        "totalTradeCount": 20423
    },
    {
        "tradeMonth": 5,
        "tradeYear": 2020,
        "tradeReportDate": "2020-07-01",
        "gradeCode": "HY",
        "totalTradeCount": 38784
    }
]

 

Corporate Debt Market Breadth

Market breadth calculations for corporate debt securities.

Dataset Info:

group dataset test dataset
fixedIncomeMarket corporateMarketBreadth corporateMarketBreadthMock

 

Sample Request
https://api.finra.org/data/group/fixedIncomeMarket/name/corporateMarketBreadthMock?limit=5

 

Sample Response
[
    {
        "declines": 2995,
        "totalVolume": 57356.579941,
        "advances": 5801,
        "unchanged": 86,
        "totalTrades": 9322,
        "tradeReportDate": "2020-03-31",
        "fiftyTwoWeekHigh": 245,
        "productCategory": "all securities",
        "fiftyTwoWeekLow": 451
    },
    {
        "declines": 2181,
        "totalVolume": 32882.185821,
        "advances": 4439,
        "unchanged": 42,
        "totalTrades": 6889,
        "tradeReportDate": "2020-03-31",
        "fiftyTwoWeekHigh": 196,
        "productCategory": "investment grade",
        "fiftyTwoWeekLow": 215
    },
    {
        "declines": 710,
        "totalVolume": 22990.974119,
        "advances": 1270,
        "unchanged": 40,
        "totalTrades": 2227,
        "tradeReportDate": "2020-03-31",
        "fiftyTwoWeekHigh": 48,
        "productCategory": "high yield",
        "fiftyTwoWeekLow": 221
    },
    {
        "declines": 104,
        "totalVolume": 1483.42,
        "advances": 92,
        "unchanged": 4,
        "totalTrades": 206,
        "tradeReportDate": "2020-03-31",
        "fiftyTwoWeekHigh": 1,
        "productCategory": "convertibles",
        "fiftyTwoWeekLow": 15
    },
    {
        "declines": 2799,
        "totalVolume": 41606.71201,
        "advances": 5530,
        "unchanged": 88,
        "totalTrades": 8807,
        "tradeReportDate": "2020-03-30",
        "fiftyTwoWeekHigh": 188,
        "productCategory": "all securities",
        "fiftyTwoWeekLow": 495
    }
]

 

Sample Request
https://api.finra.org/data/group/fixedIncomeMarket/name/corporateMarketBreadthMock

 

Sample Request Payload
{
"limit":5,
"fields":["declines","totalVolume","advances","unchanged","totalTrades"],  
"compareFilters": [ 
{"compareType": "equal", "fieldName": "productCategory", "fieldValue": "investment grade" }
]
}
 

 

Sample Response
[
    {
        "declines": 2181,
        "totalVolume": 32882.185821,
        "advances": 4439,
        "unchanged": 42,
        "totalTrades": 6889
    },
    {
        "declines": 1919,
        "totalVolume": 26562.651906,
        "advances": 4355,
        "unchanged": 37,
        "totalTrades": 6536
    },
    {
        "declines": 2149,
        "totalVolume": 26834.453353,
        "advances": 4118,
        "unchanged": 39,
        "totalTrades": 6557
    },
    {
        "declines": 1910,
        "totalVolume": 30816.176167,
        "advances": 4436,
        "unchanged": 40,
        "totalTrades": 6630
    },
    {
        "declines": 1538,
        "totalVolume": 30097.984563,
        "advances": 4870,
        "unchanged": 29,
        "totalTrades": 6726
    }
]

 

Corporate Debt Market Sentiment

Market sentiment calculations for corporate debt securities.

Dataset Info:

group dataset test dataset
fixedIncomeMarket corporateMarketSentiment corporateMarketSentimentMock

 

Sample Request
https://api.finra.org/data/group/fixedIncomeMarket/name/corporateMarketSentimentMock?limit=5

 

Sample Response
[
    {
        "totalVolume": 57375.46495,
        "totalTransactions": 89383,
        "totalTrades": 9431,
        "tradeReportDate": "2020-03-31",
        "tradeType": "all securities",
        "productCategory": "all securities"
    },
    {
        "totalVolume": 23615.53967,
        "totalTransactions": 25342,
        "totalTrades": 7232,
        "tradeReportDate": "2020-03-31",
        "tradeType": "all securities",
        "productCategory": "customer buy"
    },
    {
        "totalVolume": 21534.8051,
        "totalTransactions": 26037,
        "totalTrades": 6820,
        "tradeReportDate": "2020-03-31",
        "tradeType": "all securities",
        "productCategory": "customer sell"
    },
    {
        "totalVolume": 1577.14683,
        "totalTransactions": 2170,
        "totalTrades": 1405,
        "tradeReportDate": "2020-03-31",
        "tradeType": "all securities",
        "productCategory": "affiliate buy"
    },
    {
        "totalVolume": 2079.14393,
        "totalTransactions": 2214,
        "totalTrades": 1399,
        "tradeReportDate": "2020-03-31",
        "tradeType": "all securities",
        "productCategory": "affiliate sell"
    }
]

 

Sample Request
https://api.finra.org/data/group/fixedIncomeMarket/name/corporateMarketSentimentMock

 

Sample Request Payload
{
"limit":5,
"fields":["totalVolume","totalTransactions","totalTrades"],  
"compareFilters": [ 
{"compareType": "equal", "fieldName": "productCategory", "fieldValue": "customer sell" }
]
}
 

 

Sample Response
[
    {
        "totalVolume": 21534.8051,
        "totalTransactions": 26037,
        "totalTrades": 6820
    },
    {
        "totalVolume": 12064.95103,
        "totalTransactions": 18666,
        "totalTrades": 5014
    },
    {
        "totalVolume": 8754.9289,
        "totalTransactions": 6966,
        "totalTrades": 1631
    },
    {
        "totalVolume": 713.935,
        "totalTransactions": 373,
        "totalTrades": 153
    },
    {
        "totalVolume": 0.074,
        "totalTransactions": 11,
        "totalTrades": 9
    }
]

 

Securitized Product Capped Volume

Capped volume calculations for securitized products.

Dataset Info:

group dataset test dataset
fixedIncomeMarket securitizedProductsCappedVolume securitizedProductsCappedVolumeMock

 

Sample Request
https://api.finra.org/data/group/fixedIncomeMarket/name/securitizedProductsCappedVolumeMock?limit=5

 

Sample Response
[
    {
        "tradeMonth": 4,
        "tradeYear": 2020,
        "averageTransactionCount": 63423,
        "securitySubtype": null,
        "tradeReportDate": "2020-05-01",
        "productType": "MBS"
    },
    {
        "tradeMonth": 4,
        "tradeYear": 2020,
        "averageTransactionCount": 144406,
        "securitySubtype": "GD",
        "tradeReportDate": "2020-05-01",
        "productType": "TBA"
    },
    {
        "tradeMonth": 4,
        "tradeYear": 2020,
        "averageTransactionCount": 31987,
        "securitySubtype": "NGD",
        "tradeReportDate": "2020-05-01",
        "productType": "TBA"
    },
    {
        "tradeMonth": 4,
        "tradeYear": 2020,
        "averageTransactionCount": 24498,
        "securitySubtype": null,
        "tradeReportDate": "2020-05-01",
        "productType": "ABS"
    },
    {
        "tradeMonth": 3,
        "tradeYear": 2020,
        "averageTransactionCount": 67586,
        "securitySubtype": null,
        "tradeReportDate": "2020-05-01",
        "productType": "MBS"
    }
]

 

Sample Request
https://api.finra.org/data/group/fixedIncomeMarket/name/securitizedProductsCappedVolumeMock

 

Sample Request Payload
{
"limit":5,
"fields":["tradeMonth","tradeYear","averageTransactionCount"],  
"compareFilters": [ 
{"compareType": "equal", "fieldName": "productType", "fieldValue": "TBA" }
]
}
 

 

Sample Response
[
    {
        "tradeMonth": 4,
        "tradeYear": 2020,
        "averageTransactionCount": 144406
    },
    {
        "tradeMonth": 4,
        "tradeYear": 2020,
        "averageTransactionCount": 31987
    },
    {
        "tradeMonth": 3,
        "tradeYear": 2020,
        "averageTransactionCount": 147129
    },
    {
        "tradeMonth": 3,
        "tradeYear": 2020,
        "averageTransactionCount": 29330
    },
    {
        "tradeMonth": 2,
        "tradeYear": 2020,
        "averageTransactionCount": 153064
    }
]

 

Treasury Weekly Aggregates

Trading volume in US Treasury Securities reported to TRACE.

Dataset Info:

group dataset test dataset
fixedIncomeMarket treasuryWeeklyAggregates treasuryWeeklyAggregatesMock

 

Sample Request
https://api.finra.org/data/group/fixedIncomeMarket/name/treasuryWeeklyAggregatesMock?limit=5

 

Sample Response
[
    {
        "beginningOfWeekDate": "2020-03-02",
        "yearsToMaturity": null,
        "dealerCustomerVolume": 415.2,
        "benchmark": null,
        "atsInterdealerVolume": 151.8,
        "productCategory": "Bills"
    },
    {
        "beginningOfWeekDate": "2020-03-02",
        "yearsToMaturity": null,
        "dealerCustomerVolume": 14.3,
        "benchmark": null,
        "atsInterdealerVolume": 2.5,
        "productCategory": "FRNs"
    },
    {
        "beginningOfWeekDate": "2020-03-02",
        "yearsToMaturity": "<= 2 years",
        "dealerCustomerVolume": 175.3,
        "benchmark": "On-the-run",
        "atsInterdealerVolume": 452.7,
        "productCategory": "Nominal Coupons"
    },
    {
        "beginningOfWeekDate": "2020-03-02",
        "yearsToMaturity": "<= 2 years",
        "dealerCustomerVolume": 186.8,
        "benchmark": "Off-the-run",
        "atsInterdealerVolume": 81.2,
        "productCategory": "Nominal Coupons"
    },
    {
        "beginningOfWeekDate": "2020-03-02",
        "yearsToMaturity": "> 2 years and <= 3 years",
        "dealerCustomerVolume": 137.3,
        "benchmark": "On-the-run",
        "atsInterdealerVolume": 334.3,
        "productCategory": "Nominal Coupons"
    }
]

 

Sample Request
https://api.finra.org/data/group/fixedIncomeMarket/name/treasuryWeeklyAggregatesMock

 

Sample Request Payload
{
"limit":5,
"fields":["beginningOfWeekDate","dealerCustomerVolume","atsInterdealerVolume"],  
"compareFilters": [ 
{"compareType": "equal", "fieldName": "productCategory", "fieldValue": "FRNs" }
]
}
 

 

Sample Response
[
    {
        "beginningOfWeekDate": "2020-03-02",
        "dealerCustomerVolume": 14.3,
        "atsInterdealerVolume": 2.5
    },
    {
        "beginningOfWeekDate": "2020-03-09",
        "dealerCustomerVolume": 23.8,
        "atsInterdealerVolume": 5.7
    },
    {
        "beginningOfWeekDate": "2020-03-16",
        "dealerCustomerVolume": 30.5,
        "atsInterdealerVolume": 1.5
    },
    {
        "beginningOfWeekDate": "2020-03-23",
        "dealerCustomerVolume": 27.8,
        "atsInterdealerVolume": 2.8
    },
    {
        "beginningOfWeekDate": "2020-03-30",
        "dealerCustomerVolume": 11.1,
        "atsInterdealerVolume": 3
    }
]

 


 

Registration

The Registration API datasets provide member firms access to their registration records as stored in the Central Registration Depository (CRD).

Terms of Service

Access to the Registration datasets are governed by the following specific Terms of Service:

The specific Terms of Service for the Registration datasets are included by reference in the FINRA API Terms of Service.

Branch Associated Individuals

Breakdown of registered individuals associated with each branch of a firm.

Dataset Info:

group dataset test dataset
firm registeredIndividualBranchOfficeLocations registeredIndividualBranchOfficeLocationsMock

 

Sample Request
https://api.finra.org/data/group/firm/name/registeredIndividualBranchOfficeLocationsMock?limit=5

 

Sample Response
[
    {
        "registrations": [
            {
                "regulatorCode": "NQX"
            },
            {
                "regulatorCode": "NYSE-AMER"
            }
        ],
        "branchOfficeLocations": [
            {
                "nonRegisteredBranchIdentifier": null,
                "officeLocationEndDate": null,
                "firmCrdNumber": 3000005,
                "officeLocationStartDate": "2002-10-15",
                "officeLocationRoleText": null,
                "branchCrdNumber": 106560,
                "officeLocationType": "LOCATED AT"
            },
            {
                "nonRegisteredBranchIdentifier": null,
                "officeLocationEndDate": null,
                "firmCrdNumber": 3000005,
                "officeLocationStartDate": "2003-06-15",
                "officeLocationRoleText": null,
                "branchCrdNumber": 106561,
                "officeLocationType": "LOCATED AT"
            },
            {
                "nonRegisteredBranchIdentifier": null,
                "officeLocationEndDate": null,
                "firmCrdNumber": 3000005,
                "officeLocationStartDate": "2003-02-15",
                "officeLocationRoleText": null,
                "branchCrdNumber": 106562,
                "officeLocationType": "LOCATED AT"
            }
        ],
        "individualCrdNumber": 1
    },
    {
        "registrations": [
            {
                "regulatorCode": "NYSE-AMER"
            },
            {
                "regulatorCode": "NQX"
            }
        ],
        "branchOfficeLocations": [
            {
                "nonRegisteredBranchIdentifier": null,
                "officeLocationEndDate": null,
                "firmCrdNumber": 3000005,
                "officeLocationStartDate": "2014-09-25",
                "officeLocationRoleText": "PERSON-IN-CHARGE",
                "branchCrdNumber": 106560,
                "officeLocationType": "SUPERVISED FROM"
            },
            {
                "nonRegisteredBranchIdentifier": null,
                "officeLocationEndDate": null,
                "firmCrdNumber": 3000005,
                "officeLocationStartDate": "2015-02-25",
                "officeLocationRoleText": null,
                "branchCrdNumber": 106561,
                "officeLocationType": "LOCATED AT"
            },
            {
                "nonRegisteredBranchIdentifier": null,
                "officeLocationEndDate": null,
                "firmCrdNumber": 3000005,
                "officeLocationStartDate": "2015-03-25",
                "officeLocationRoleText": null,
                "branchCrdNumber": 106562,
                "officeLocationType": "SUPERVISED FROM"
            }
        ],
        "individualCrdNumber": 10
    },
    {
        "registrations": [
            {
                "regulatorCode": "CBOE C2"
            },
            {
                "regulatorCode": "MEMX"
            }
        ],
        "branchOfficeLocations": [
            {
                "nonRegisteredBranchIdentifier": null,
                "officeLocationEndDate": null,
                "firmCrdNumber": 3000005,
                "officeLocationStartDate": "1989-09-11",
                "officeLocationRoleText": null,
                "branchCrdNumber": 106560,
                "officeLocationType": "SUPERVISED FROM"
            },
            {
                "nonRegisteredBranchIdentifier": null,
                "officeLocationEndDate": null,
                "firmCrdNumber": 3000005,
                "officeLocationStartDate": "1989-02-11",
                "officeLocationRoleText": "PERSON-IN-CHARGE",
                "branchCrdNumber": 106561,
                "officeLocationType": "LOCATED AT"
            },
            {
                "nonRegisteredBranchIdentifier": null,
                "officeLocationEndDate": null,
                "firmCrdNumber": 3000005,
                "officeLocationStartDate": "1989-08-11",
                "officeLocationRoleText": null,
                "branchCrdNumber": 106562,
                "officeLocationType": "LOCATED AT"
            }
        ],
        "individualCrdNumber": 100
    },
    {
        "registrations": [
            {
                "regulatorCode": "MIAX OPTIONS"
            },
            {
                "regulatorCode": "NYSE-AMER"
            }
        ],
        "branchOfficeLocations": [
            {
                "nonRegisteredBranchIdentifier": null,
                "officeLocationEndDate": null,
                "firmCrdNumber": 3000005,
                "officeLocationStartDate": "1999-07-12",
                "officeLocationRoleText": null,
                "branchCrdNumber": 106560,
                "officeLocationType": "SUPERVISED FROM"
            },
            {
                "nonRegisteredBranchIdentifier": null,
                "officeLocationEndDate": null,
                "firmCrdNumber": 3000005,
                "officeLocationStartDate": "2000-02-12",
                "officeLocationRoleText": null,
                "branchCrdNumber": 106561,
                "officeLocationType": "LOCATED AT"
            },
            {
                "nonRegisteredBranchIdentifier": null,
                "officeLocationEndDate": null,
                "firmCrdNumber": 3000005,
                "officeLocationStartDate": "2000-04-12",
                "officeLocationRoleText": null,
                "branchCrdNumber": 106562,
                "officeLocationType": "SUPERVISED FROM"
            }
        ],
        "individualCrdNumber": 1000
    },
    {
        "registrations": [
            {
                "regulatorCode": "NYSE-CHI"
            },
            {
                "regulatorCode": "HI"
            }
        ],
        "branchOfficeLocations": [
            {
                "nonRegisteredBranchIdentifier": null,
                "officeLocationEndDate": null,
                "firmCrdNumber": 3000005,
                "officeLocationStartDate": "1972-09-17",
                "officeLocationRoleText": null,
                "branchCrdNumber": 106560,
                "officeLocationType": "LOCATED AT"
            },
            {
                "nonRegisteredBranchIdentifier": null,
                "officeLocationEndDate": null,
                "firmCrdNumber": 3000005,
                "officeLocationStartDate": "1972-05-17",
                "officeLocationRoleText": "PERSON-IN-CHARGE",
                "branchCrdNumber": 106561,
                "officeLocationType": "LOCATED AT"
            },
            {
                "nonRegisteredBranchIdentifier": null,
                "officeLocationEndDate": null,
                "firmCrdNumber": 3000005,
                "officeLocationStartDate": "1972-11-17",
                "officeLocationRoleText": "PERSON-IN-CHARGE",
                "branchCrdNumber": 106562,
                "officeLocationType": "SUPERVISED FROM"
            },
            {
                "nonRegisteredBranchIdentifier": null,
                "officeLocationEndDate": null,
                "firmCrdNumber": 3000005,
                "officeLocationStartDate": "2009-09-13",
                "officeLocationRoleText": null,
                "branchCrdNumber": 106560,
                "officeLocationType": "LOCATED AT"
            },
            {
                "nonRegisteredBranchIdentifier": null,
                "officeLocationEndDate": null,
                "firmCrdNumber": 3000005,
                "officeLocationStartDate": "2009-02-13",
                "officeLocationRoleText": null,
                "branchCrdNumber": 106561,
                "officeLocationType": "SUPERVISED FROM"
            },
            {
                "nonRegisteredBranchIdentifier": null,
                "officeLocationEndDate": null,
                "firmCrdNumber": 3000005,
                "officeLocationStartDate": "2009-04-13",
                "officeLocationRoleText": null,
                "branchCrdNumber": 106562,
                "officeLocationType": "SUPERVISED FROM"
            }
        ],
        "individualCrdNumber": 10000
    }
]

 

Sample Request
https://api.finra.org/data/group/firm/name/registeredIndividualBranchOfficeLocationsMock

 

Sample Request Payload
{
"limit":5,
"fields":["branchOfficeLocations.firmCrdNumber","branchOfficeLocations.officeLocationType","registrations.regulatorCode"],
"compareFilters": [ 
{"compareType": "equal", "fieldName": "individualCrdNumber", "fieldValue": 10 }
]
}
 

 

Sample Response
[
    {
        "registrations": [
            {
                "regulatorCode": "NYSE-AMER"
            },
            {
                "regulatorCode": "NQX"
            }
        ],
        "branchOfficeLocations": [
            {
                "firmCrdNumber": 3000005,
                "officeLocationType": "SUPERVISED FROM"
            },
            {
                "firmCrdNumber": 3000005,
                "officeLocationType": "LOCATED AT"
            },
            {
                "firmCrdNumber": 3000005,
                "officeLocationType": "SUPERVISED FROM"
            }
        ]
    }
]

 

Branch Office

Summary information about each branch associated with a firm.

Dataset Info:

group dataset test dataset
firm branchOffice branchOfficeMock

 

Sample Request
https://api.finra.org/data/group/firm/name/branchOfficeMock?limit=5

 

Sample Response
[
    {
        "branchDeficiencyStatusCode": "Clear",
        "registeredLocationFlag": "NO",
        "msrbSupervisoryJurisdictionFlag": "NO",
        "branchTypeCode": "IA ONLY",
        "branchBillingCode": "Q9H8SRC3SY",
        "branchScheduleENumber": "MMRECN0B",
        "privateResidenceFlag": "NO",
        "brokerDealerMainOfficeFlag": "NO",
        "contractToOperateFlag": "YES",
        "supervisingBranches": [
            {
                "branchCrdNumber": 1631868154736462764
            }
        ],
        "branchAddress": {
            "cityName": "Alexandria",
            "stateCode": "MO"
        },
        "operationalStatusCode": "Inactive",
        "firmCrdNumber": 3000005,
        "websiteAddresses": [
            {
                "websiteAddress": "https://QpXZEMuuXB.com"
            }
        ],
        "branchCode": "GHQIAYPD",
        "officeOfSupervisoryJurisdictionFlag": "NO",
        "otherRecordLocationsFlag": "NO",
        "investmentAdviserMainOfficeFlag": "YES",
        "branchCrdNumber": null,
        "otherBusinessNames": [
            {
                "otherBusinessName": "ZolvRaGOGQapIGmMkpPnmdYNxaGbiR"
            }
        ]
    },
    {
        "branchDeficiencyStatusCode": "Clear",
        "registeredLocationFlag": "YES",
        "msrbSupervisoryJurisdictionFlag": "YES",
        "branchTypeCode": "BD ONLY",
        "branchBillingCode": "PZ8MRPLTOQ",
        "branchScheduleENumber": "YQPE0S1A",
        "privateResidenceFlag": "NO",
        "brokerDealerMainOfficeFlag": "YES",
        "contractToOperateFlag": "NO",
        "supervisingBranches": [
            {
                "branchCrdNumber": -3311447650538918126
            }
        ],
        "branchAddress": {
            "cityName": "Normal",
            "stateCode": "MS"
        },
        "operationalStatusCode": "Active",
        "firmCrdNumber": 3000005,
        "websiteAddresses": [
            {
                "websiteAddress": "https://HHtLqRuSak.com"
            }
        ],
        "branchCode": "QD8PE8DV",
        "officeOfSupervisoryJurisdictionFlag": "NO",
        "otherRecordLocationsFlag": "NO",
        "investmentAdviserMainOfficeFlag": "NO",
        "branchCrdNumber": 50002,
        "otherBusinessNames": [
            {
                "otherBusinessName": "jXxhqzpkYZMvsUNXOKelieSZveaFQL"
            }
        ]
    },
    {
        "branchDeficiencyStatusCode": "Clear",
        "registeredLocationFlag": "NO",
        "msrbSupervisoryJurisdictionFlag": "NO",
        "branchTypeCode": "JOINT",
        "branchBillingCode": "IWZIT4MSWH",
        "branchScheduleENumber": "CYANPMSH",
        "privateResidenceFlag": "NO",
        "brokerDealerMainOfficeFlag": "NO",
        "contractToOperateFlag": "NO",
        "branchAddress": {
            "cityName": "Lewisville",
            "stateCode": "CA"
        },
        "operationalStatusCode": "Inactive",
        "firmCrdNumber": 3000005,
        "branchCode": "BQYICAU6",
        "officeOfSupervisoryJurisdictionFlag": "NO",
        "otherRecordLocationsFlag": "NO",
        "investmentAdviserMainOfficeFlag": "YES",
        "branchCrdNumber": null
    },
    {
        "branchDeficiencyStatusCode": "Clear",
        "registeredLocationFlag": "YES",
        "msrbSupervisoryJurisdictionFlag": "NO",
        "branchTypeCode": "IA ONLY",
        "branchBillingCode": "5M7VV3CFUU",
        "branchScheduleENumber": "EN3N0R5B",
        "privateResidenceFlag": "NO",
        "brokerDealerMainOfficeFlag": "NO",
        "contractToOperateFlag": "NO",
        "supervisingBranches": [
            {
                "branchCrdNumber": -1749978842404749301
            }
        ],
        "branchAddress": {
            "cityName": "Milwaukee",
            "stateCode": "MO"
        },
        "operationalStatusCode": "Active",
        "firmCrdNumber": 3000005,
        "websiteAddresses": [
            {
                "websiteAddress": "https://pQOxRfWCGm.com"
            }
        ],
        "branchCode": "TZOCQA7Z",
        "officeOfSupervisoryJurisdictionFlag": "NO",
        "otherRecordLocationsFlag": "YES",
        "investmentAdviserMainOfficeFlag": "NO",
        "branchCrdNumber": 50003,
        "otherBusinessNames": [
            {
                "otherBusinessName": "rkfBjxiPQnWUUWsPBHeXlQmwHNtEyD"
            }
        ]
    },
    {
        "branchDeficiencyStatusCode": "Clear",
        "registeredLocationFlag": "NO",
        "msrbSupervisoryJurisdictionFlag": "YES",
        "branchTypeCode": "JOINT",
        "branchBillingCode": "LSQ3QSVGFK",
        "branchScheduleENumber": "44RON9ZZ",
        "privateResidenceFlag": "NO",
        "brokerDealerMainOfficeFlag": "NO",
        "contractToOperateFlag": "NO",
        "branchAddress": {
            "cityName": "Columbia",
            "stateCode": "GA"
        },
        "operationalStatusCode": "Active",
        "firmCrdNumber": 3000005,
        "branchCode": "UPNUERTU",
        "officeOfSupervisoryJurisdictionFlag": "NO",
        "otherRecordLocationsFlag": "NO",
        "investmentAdviserMainOfficeFlag": "NO",
        "branchCrdNumber": null
    }
]

 

Sample Request
https://api.finra.org/data/group/firm/name/branchOfficeMock

 

Sample Request Payload
{
"limit":5,
"fields":["branchDeficiencyStatusCode","branchTypeCode","brokerDealerMainOfficeFlag","supervisingBranches.branchCrdNumber"],
"compareFilters": [ 
{"compareType": "equal", "fieldName": "investmentAdviserMainOfficeFlag", "fieldValue": "YES" }
]
}
 

 

Sample Response
[
    {
        "branchDeficiencyStatusCode": "Clear",
        "branchTypeCode": "IA ONLY",
        "brokerDealerMainOfficeFlag": "NO",
        "supervisingBranches": [
            {
                "branchCrdNumber": 1631868154736462764
            }
        ]
    },
    {
        "branchDeficiencyStatusCode": "Clear",
        "branchTypeCode": "JOINT",
        "brokerDealerMainOfficeFlag": "NO"
    },
    {
        "branchDeficiencyStatusCode": "Clear",
        "branchTypeCode": "JOINT",
        "brokerDealerMainOfficeFlag": "NO",
        "supervisingBranches": [
            {
                "branchCrdNumber": -7683619162827536869
            }
        ]
    },
    {
        "branchDeficiencyStatusCode": "Clear",
        "branchTypeCode": "JOINT",
        "brokerDealerMainOfficeFlag": "NO",
        "supervisingBranches": [
            {
                "branchCrdNumber": -3027219148742801724
            }
        ]
    },
    {
        "branchDeficiencyStatusCode": "Clear",
        "branchTypeCode": "IA ONLY",
        "brokerDealerMainOfficeFlag": "NO",
        "supervisingBranches": [
            {
                "branchCrdNumber": -22787229865626068
            }
        ]
    }
]

 

Branch Office Associated Individuals

List of individuals associated with a specific branch identified by a branch CRD number.

Dataset Info:

group dataset test dataset
firm branchOfficeAssociatedIndividuals branchOfficeAssociatedIndividualsMock

 

Sample Request
https://api.finra.org/data/group/firm/name/branchOfficeAssociatedIndividualsMock?limit=5

 

Sample Response
[
    {
        "branchAddress": {
            "stateCode": "MO"
        },
        "firmCrdNumber": 3000005,
        "individuals": [
            {
                "firstName": "Collen",
                "lastName": "Tordoya",
                "independentContractorFlag": "NO",
                "archiveDisclosuresFlag": "NO",
                "statutoryDisqualificationFlag": "NO",
                "suffixName": null,
                "middleName": null,
                "currentDisclosuresFlag": "NO",
                "individualCrdNumber": 74379799,
                "isActive": null,
                "officeLocationRoleText": "STAFF",
                "officeLocationType": "LOCATED AT"
            },
            {
                "firstName": "Fry",
                "lastName": "Best",
                "independentContractorFlag": "NO",
                "archiveDisclosuresFlag": "NO",
                "statutoryDisqualificationFlag": "NO",
                "suffixName": null,
                "middleName": null,
                "currentDisclosuresFlag": "NO",
                "individualCrdNumber": 11364198,
                "isActive": null,
                "officeLocationRoleText": "STAFF",
                "officeLocationType": "LOCATED AT"
            },
            {
                "firstName": "Jump",
                "lastName": "Asenova",
                "independentContractorFlag": "NO",
                "archiveDisclosuresFlag": "NO",
                "statutoryDisqualificationFlag": "NO",
                "suffixName": null,
                "middleName": null,
                "currentDisclosuresFlag": "YES",
                "individualCrdNumber": 81722121,
                "isActive": null,
                "officeLocationRoleText": "STAFF",
                "officeLocationType": "LOCATED AT"
            }
        ],
        "branchCrdNumber": null
    },
    {
        "branchAddress": {
            "stateCode": "MS"
        },
        "firmCrdNumber": 3000005,
        "individuals": [
            {
                "firstName": "Lorimer",
                "lastName": "Vila",
                "independentContractorFlag": "NO",
                "archiveDisclosuresFlag": "NO",
                "statutoryDisqualificationFlag": "NO",
                "suffixName": null,
                "middleName": null,
                "currentDisclosuresFlag": "NO",
                "individualCrdNumber": 84962044,
                "isActive": null,
                "officeLocationRoleText": "STAFF",
                "officeLocationType": "LOCATED AT"
            },
            {
                "firstName": "Gussy",
                "lastName": "Heredero",
                "independentContractorFlag": "NO",
                "archiveDisclosuresFlag": "NO",
                "statutoryDisqualificationFlag": "NO",
                "suffixName": null,
                "middleName": null,
                "currentDisclosuresFlag": "NO",
                "individualCrdNumber": 25181016,
                "isActive": null,
                "officeLocationRoleText": "STAFF",
                "officeLocationType": "LOCATED AT"
            },
            {
                "firstName": "Rodney",
                "lastName": "Alameda",
                "independentContractorFlag": "NO",
                "archiveDisclosuresFlag": "NO",
                "statutoryDisqualificationFlag": "NO",
                "suffixName": null,
                "middleName": null,
                "currentDisclosuresFlag": "NO",
                "individualCrdNumber": 82009296,
                "isActive": null,
                "officeLocationRoleText": "STAFF",
                "officeLocationType": "LOCATED AT"
            }
        ],
        "branchCrdNumber": 50002
    },
    {
        "branchAddress": {
            "stateCode": "CA"
        },
        "firmCrdNumber": 3000005,
        "individuals": [
            {
                "firstName": "Paymar",
                "lastName": "Angelov",
                "independentContractorFlag": "NO",
                "archiveDisclosuresFlag": "NO",
                "statutoryDisqualificationFlag": "NO",
                "suffixName": null,
                "middleName": null,
                "currentDisclosuresFlag": "NO",
                "individualCrdNumber": 48077155,
                "isActive": null,
                "officeLocationRoleText": "SUPERVISOR",
                "officeLocationType": "SUPERVISED FROM"
            },
            {
                "firstName": "Salbu",
                "lastName": "Piñana",
                "independentContractorFlag": "NO",
                "archiveDisclosuresFlag": "NO",
                "statutoryDisqualificationFlag": "NO",
                "suffixName": null,
                "middleName": null,
                "currentDisclosuresFlag": "NO",
                "individualCrdNumber": 50696496,
                "isActive": null,
                "officeLocationRoleText": "STAFF",
                "officeLocationType": "LOCATED AT"
            },
            {
                "firstName": "Ber",
                "lastName": "Bensaad",
                "independentContractorFlag": "NO",
                "archiveDisclosuresFlag": "NO",
                "statutoryDisqualificationFlag": "NO",
                "suffixName": null,
                "middleName": null,
                "currentDisclosuresFlag": "NO",
                "individualCrdNumber": 22351559,
                "isActive": null,
                "officeLocationRoleText": "STAFF",
                "officeLocationType": "LOCATED AT"
            }
        ],
        "branchCrdNumber": null
    },
    {
        "branchAddress": {
            "stateCode": "MO"
        },
        "firmCrdNumber": 3000005,
        "individuals": [
            {
                "firstName": "Walters",
                "lastName": "Benjumea",
                "independentContractorFlag": "NO",
                "archiveDisclosuresFlag": "NO",
                "statutoryDisqualificationFlag": "NO",
                "suffixName": null,
                "middleName": null,
                "currentDisclosuresFlag": "NO",
                "individualCrdNumber": 62904385,
                "isActive": null,
                "officeLocationRoleText": "STAFF",
                "officeLocationType": "LOCATED AT"
            },
            {
                "firstName": "Rawdon",
                "lastName": "Condo",
                "independentContractorFlag": "NO",
                "archiveDisclosuresFlag": "NO",
                "statutoryDisqualificationFlag": "NO",
                "suffixName": null,
                "middleName": null,
                "currentDisclosuresFlag": "NO",
                "individualCrdNumber": 91287158,
                "isActive": null,
                "officeLocationRoleText": "STAFF",
                "officeLocationType": "LOCATED AT"
            },
            {
                "firstName": "Aramanta",
                "lastName": "Campomanes",
                "independentContractorFlag": "NO",
                "archiveDisclosuresFlag": "NO",
                "statutoryDisqualificationFlag": "NO",
                "suffixName": null,
                "middleName": null,
                "currentDisclosuresFlag": "NO",
                "individualCrdNumber": 31672374,
                "isActive": null,
                "officeLocationRoleText": "SUPERVISOR",
                "officeLocationType": "SUPERVISED FROM"
            }
        ],
        "branchCrdNumber": 50003
    },
    {
        "branchAddress": {
            "stateCode": "GA"
        },
        "firmCrdNumber": 3000005,
        "individuals": [
            {
                "firstName": "Coleen",
                "lastName": "Mirabent",
                "independentContractorFlag": "YES",
                "archiveDisclosuresFlag": "NO",
                "statutoryDisqualificationFlag": "NO",
                "suffixName": null,
                "middleName": null,
                "currentDisclosuresFlag": "NO",
                "individualCrdNumber": 6660256,
                "isActive": null,
                "officeLocationRoleText": "STAFF",
                "officeLocationType": "LOCATED AT"
            },
            {
                "firstName": "Jervis",
                "lastName": "Aharrar",
                "independentContractorFlag": "NO",
                "archiveDisclosuresFlag": "NO",
                "statutoryDisqualificationFlag": "NO",
                "suffixName": null,
                "middleName": null,
                "currentDisclosuresFlag": "NO",
                "individualCrdNumber": 40219009,
                "isActive": null,
                "officeLocationRoleText": "STAFF",
                "officeLocationType": "LOCATED AT"
            },
            {
                "firstName": "Jamilla",
                "lastName": "Millon",
                "independentContractorFlag": "NO",
                "archiveDisclosuresFlag": "YES",
                "statutoryDisqualificationFlag": "YES",
                "suffixName": null,
                "middleName": null,
                "currentDisclosuresFlag": "YES",
                "individualCrdNumber": 86012451,
                "isActive": null,
                "officeLocationRoleText": "PERSON-IN-CHARGE",
                "officeLocationType": "SUPERVISED FROM"
            }
        ],
        "branchCrdNumber": null
    }
]

 

Sample Request
https://api.finra.org/data/group/firm/name/branchOfficeAssociatedIndividualsMock

 

Sample Request Payload
{
"limit":5,
"compareFilters": [ 
{"compareType": "equal", "fieldName": "branchAddress.stateCode", "fieldValue": "CA" }
]
}
 

 

Sample Response
[
    {
        "branchAddress": {
            "stateCode": "CA"
        },
        "firmCrdNumber": 3000005,
        "individuals": [
            {
                "firstName": "Paymar",
                "lastName": "Angelov",
                "independentContractorFlag": "NO",
                "archiveDisclosuresFlag": "NO",
                "statutoryDisqualificationFlag": "NO",
                "suffixName": null,
                "middleName": null,
                "currentDisclosuresFlag": "NO",
                "individualCrdNumber": 48077155,
                "isActive": null,
                "officeLocationRoleText": "SUPERVISOR",
                "officeLocationType": "SUPERVISED FROM"
            },
            {
                "firstName": "Salbu",
                "lastName": "Piñana",
                "independentContractorFlag": "NO",
                "archiveDisclosuresFlag": "NO",
                "statutoryDisqualificationFlag": "NO",
                "suffixName": null,
                "middleName": null,
                "currentDisclosuresFlag": "NO",
                "individualCrdNumber": 50696496,
                "isActive": null,
                "officeLocationRoleText": "STAFF",
                "officeLocationType": "LOCATED AT"
            },
            {
                "firstName": "Ber",
                "lastName": "Bensaad",
                "independentContractorFlag": "NO",
                "archiveDisclosuresFlag": "NO",
                "statutoryDisqualificationFlag": "NO",
                "suffixName": null,
                "middleName": null,
                "currentDisclosuresFlag": "NO",
                "individualCrdNumber": 22351559,
                "isActive": null,
                "officeLocationRoleText": "STAFF",
                "officeLocationType": "LOCATED AT"
            }
        ],
        "branchCrdNumber": null
    },
    {
        "branchAddress": {
            "stateCode": "CA"
        },
        "firmCrdNumber": 3000005,
        "individuals": [
            {
                "firstName": "Wardle",
                "lastName": "Ene",
                "independentContractorFlag": "NO",
                "archiveDisclosuresFlag": "NO",
                "statutoryDisqualificationFlag": "NO",
                "suffixName": null,
                "middleName": null,
                "currentDisclosuresFlag": "YES",
                "individualCrdNumber": 95836799,
                "isActive": null,
                "officeLocationRoleText": "STAFF",
                "officeLocationType": "LOCATED AT"
            },
            {
                "firstName": "Westbrooke",
                "lastName": "Beamonte",
                "independentContractorFlag": "NO",
                "archiveDisclosuresFlag": "NO",
                "statutoryDisqualificationFlag": "NO",
                "suffixName": null,
                "middleName": null,
                "currentDisclosuresFlag": "NO",
                "individualCrdNumber": 89282213,
                "isActive": null,
                "officeLocationRoleText": "STAFF",
                "officeLocationType": "LOCATED AT"
            },
            {
                "firstName": "Ardeen",
                "lastName": "Artidiello",
                "independentContractorFlag": "NO",
                "archiveDisclosuresFlag": "NO",
                "statutoryDisqualificationFlag": "NO",
                "suffixName": null,
                "middleName": null,
                "currentDisclosuresFlag": "NO",
                "individualCrdNumber": 56912307,
                "isActive": null,
                "officeLocationRoleText": "SUPERVISOR",
                "officeLocationType": "SUPERVISED FROM"
            }
        ],
        "branchCrdNumber": 50043
    },
    {
        "branchAddress": {
            "stateCode": "CA"
        },
        "firmCrdNumber": 3000005,
        "individuals": [
            {
                "firstName": "Viafore",
                "lastName": "Canduela",
                "independentContractorFlag": "NO",
                "archiveDisclosuresFlag": "NO",
                "statutoryDisqualificationFlag": "NO",
                "suffixName": null,
                "middleName": null,
                "currentDisclosuresFlag": "NO",
                "individualCrdNumber": 7528065,
                "isActive": null,
                "officeLocationRoleText": "STAFF",
                "officeLocationType": "LOCATED AT"
            },
            {
                "firstName": "Grevera",
                "lastName": "Endara",
                "independentContractorFlag": "NO",
                "archiveDisclosuresFlag": "NO",
                "statutoryDisqualificationFlag": "NO",
                "suffixName": null,
                "middleName": null,
                "currentDisclosuresFlag": "NO",
                "individualCrdNumber": 12755014,
                "isActive": null,
                "officeLocationRoleText": "STAFF",
                "officeLocationType": "LOCATED AT"
            },
            {
                "firstName": "Yetac",
                "lastName": "Penichet",
                "independentContractorFlag": "NO",
                "archiveDisclosuresFlag": "NO",
                "statutoryDisqualificationFlag": "NO",
                "suffixName": null,
                "middleName": null,
                "currentDisclosuresFlag": "NO",
                "individualCrdNumber": 87005134,
                "isActive": null,
                "officeLocationRoleText": "STAFF",
                "officeLocationType": "LOCATED AT"
            }
        ],
        "branchCrdNumber": 50075
    },
    {
        "branchAddress": {
            "stateCode": "CA"
        },
        "firmCrdNumber": 3000005,
        "individuals": [
            {
                "firstName": "Clymer",
                "lastName": "Sangare",
                "independentContractorFlag": "NO",
                "archiveDisclosuresFlag": "NO",
                "statutoryDisqualificationFlag": "NO",
                "suffixName": null,
                "middleName": null,
                "currentDisclosuresFlag": "NO",
                "individualCrdNumber": 72317031,
                "isActive": null,
                "officeLocationRoleText": "STAFF",
                "officeLocationType": "LOCATED AT"
            },
            {
                "firstName": "Lucienne",
                "lastName": "Solabarrieta",
                "independentContractorFlag": "YES",
                "archiveDisclosuresFlag": "NO",
                "statutoryDisqualificationFlag": "NO",
                "suffixName": null,
                "middleName": null,
                "currentDisclosuresFlag": "NO",
                "individualCrdNumber": 79538750,
                "isActive": null,
                "officeLocationRoleText": "STAFF",
                "officeLocationType": "LOCATED AT"
            },
            {
                "firstName": "Anestassia",
                "lastName": "Valdecantos",
                "independentContractorFlag": "NO",
                "archiveDisclosuresFlag": "NO",
                "statutoryDisqualificationFlag": "NO",
                "suffixName": null,
                "middleName": null,
                "currentDisclosuresFlag": "NO",
                "individualCrdNumber": 63126667,
                "isActive": null,
                "officeLocationRoleText": "STAFF",
                "officeLocationType": "LOCATED AT"
            }
        ],
        "branchCrdNumber": 50120
    },
    {
        "branchAddress": {
            "stateCode": "CA"
        },
        "firmCrdNumber": 3000005,
        "individuals": [
            {
                "firstName": "Isolda",
                "lastName": "Terres",
                "independentContractorFlag": "NO",
                "archiveDisclosuresFlag": "NO",
                "statutoryDisqualificationFlag": "NO",
                "suffixName": null,
                "middleName": null,
                "currentDisclosuresFlag": "NO",
                "individualCrdNumber": 40597637,
                "isActive": null,
                "officeLocationRoleText": "STAFF",
                "officeLocationType": "LOCATED AT"
            },
            {
                "firstName": "Huntingdon",
                "lastName": "Alayeto",
                "independentContractorFlag": "NO",
                "archiveDisclosuresFlag": "NO",
                "statutoryDisqualificationFlag": "NO",
                "suffixName": null,
                "middleName": null,
                "currentDisclosuresFlag": "NO",
                "individualCrdNumber": 59126195,
                "isActive": null,
                "officeLocationRoleText": "STAFF",
                "officeLocationType": "LOCATED AT"
            },
            {
                "firstName": "Jerusalem",
                "lastName": "Napoles",
                "independentContractorFlag": "NO",
                "archiveDisclosuresFlag": "NO",
                "statutoryDisqualificationFlag": "NO",
                "suffixName": null,
                "middleName": null,
                "currentDisclosuresFlag": "NO",
                "individualCrdNumber": 85334315,
                "isActive": null,
                "officeLocationRoleText": "STAFF",
                "officeLocationType": "LOCATED AT"
            }
        ],
        "branchCrdNumber": null
    }
]

 

Branch Office Details

Detailed information about each branch associated with a firm.

Dataset Info:

group dataset test dataset
firm branchOfficeDetails branchOfficeDetailsMock

 

Sample Request
https://api.finra.org/data/group/firm/name/branchOfficeDetailsMock?limit=5

 

Sample Response
[
    {
        "branchFaxNumber": "(456) 144-0497",
        "sharesSpaceWithFlag": "NO",
        "financialInterestDetails": "CREDIT UNION IS RESPONSIBLE FOR ALL EXPENSES ASSOCIATED WITH MARKETING THE PROGRAM",
        "branchAddress": {
            "stateCode": "MO"
        },
        "othersResponsibleForExpenseFlag": "NO",
        "firmCrdNumber": 3000005,
        "branchTelephoneNumber": "(138) 723-4638",
        "branchCrdNumber": null,
        "responsibleForEmploymentsFlag": "YES",
        "branchFinraDistrict": "6-Dallas",
        "branchRegistrationNoticeStatusType": null,
        "postDatedCloseDate": null
    },
    {
        "branchFaxNumber": "(990) 401-5552",
        "sharesSpaceWithFlag": "NO",
        "financialInterestDetails": "ASSOCIATE PERSON HAS 100% INTEREST IN AND RESPONSIBILTIY FOR FINANCES OF APPROVED OUTSIDE BUSINESS ACTIVIITES CONDUCTED AT THIS LOCATION.",
        "branchAddress": {
            "stateCode": "MS"
        },
        "othersResponsibleForExpenseFlag": "YES",
        "firmCrdNumber": 3000005,
        "branchTelephoneNumber": "(114) 515-4146",
        "branchCrdNumber": 50002,
        "responsibleForEmploymentsFlag": "NO",
        "branchFinraDistrict": "11-Boston",
        "branchRegistrationNoticeStatusType": null,
        "postDatedCloseDate": null
    },
    {
        "branchFaxNumber": "(733) 112-5491",
        "sharesSpaceWithFlag": "NO",
        "financialInterestDetails": "REPRESENTATIVE IS RESPONSIBLE FOR THE EXPENSES OF THE BRANCH OFFICE.",
        "branchAddress": {
            "stateCode": "CA"
        },
        "othersResponsibleForExpenseFlag": "YES",
        "firmCrdNumber": 3000005,
        "branchTelephoneNumber": "(539) 776-0061",
        "branchCrdNumber": null,
        "responsibleForEmploymentsFlag": "NO",
        "branchFinraDistrict": "Florida",
        "branchRegistrationNoticeStatusType": null,
        "postDatedCloseDate": "2019-12-16"
    },
    {
        "branchFaxNumber": "(762) 235-9764",
        "sharesSpaceWithFlag": "NO",
        "financialInterestDetails": "LIBERTY BANK IS RESPONSIBLE FOR PAYING ALL EXPENSES AT THIS LOCATION.",
        "branchAddress": {
            "stateCode": "MO"
        },
        "othersResponsibleForExpenseFlag": "NO",
        "firmCrdNumber": 3000005,
        "branchTelephoneNumber": "(090) 657-2750",
        "branchCrdNumber": 50003,
        "responsibleForEmploymentsFlag": "NO",
        "branchFinraDistrict": "10-New York",
        "branchRegistrationNoticeStatusType": null,
        "postDatedCloseDate": null
    },
    {
        "branchFaxNumber": "(949) 792-8748",
        "sharesSpaceWithFlag": "NO",
        "financialInterestDetails": "REP PAYS ALL EXPENSES FOR THE BRANCH OFFICE.",
        "branchAddress": {
            "stateCode": "GA"
        },
        "othersResponsibleForExpenseFlag": "NO",
        "firmCrdNumber": 3000005,
        "branchTelephoneNumber": "(367) 931-5438",
        "branchCrdNumber": null,
        "responsibleForEmploymentsFlag": "YES",
        "branchFinraDistrict": "2-Los Angeles",
        "branchRegistrationNoticeStatusType": null,
        "postDatedCloseDate": null
    }
]

 

Sample Request
https://api.finra.org/data/group/firm/name/branchOfficeDetailsMock

 

Sample Request Payload
{
"limit":5,
"fields":["branchFaxNumber","financialInterestDetails","firmCrdNumber","branchFinraDistrict"],
"compareFilters": [ 
{"compareType": "equal", "fieldName": "responsibleForEmploymentsFlag", "fieldValue": "YES" }
]
}
 

 

Sample Response
[
    {
        "branchFaxNumber": "(456) 144-0497",
        "financialInterestDetails": "CREDIT UNION IS RESPONSIBLE FOR ALL EXPENSES ASSOCIATED WITH MARKETING THE PROGRAM",
        "firmCrdNumber": 3000005,
        "branchFinraDistrict": "6-Dallas"
    },
    {
        "branchFaxNumber": "(949) 792-8748",
        "financialInterestDetails": "REP PAYS ALL EXPENSES FOR THE BRANCH OFFICE.",
        "firmCrdNumber": 3000005,
        "branchFinraDistrict": "2-Los Angeles"
    },
    {
        "branchFaxNumber": "(892) 722-3095",
        "financialInterestDetails": "CHUN HA PAYS EXPENSES",
        "firmCrdNumber": 3000005,
        "branchFinraDistrict": "TFCE FinOp"
    },
    {
        "branchFaxNumber": "(990) 211-6679",
        "financialInterestDetails": "RESPONSIBLE FOR ALL OFFICE EXPENSES INCLUDING:  RENT, TELEPHONE, INTERNET, OFFICE SUPPLIES AND OTHER CUSTOMARY EXPENSES.",
        "firmCrdNumber": 3000005,
        "branchFinraDistrict": "9-districts of Columbia"
    },
    {
        "branchFaxNumber": "(271) 935-2791",
        "financialInterestDetails": "RONALD BARTLETT IS RESPONSIBLE FOR ALL EXPENSES PERTAINING TO THIS BRANCH OFFICE.",
        "firmCrdNumber": 3000005,
        "branchFinraDistrict": "ROOR Unit 3"
    }
]

 

Branch Office Financial Activities

Financial activities conducted at each branch associated with a firm.

Dataset Info:

group dataset test dataset
firm branchOfficeFinancialActivities branchOfficeFinancialActivitiesMock

 

Sample Request
https://api.finra.org/data/group/firm/name/branchOfficeFinancialActivitiesMock?limit=5

 

Sample Response
[
    {
        "branchAddress": {
            "stateCode": "MO"
        },
        "firmCrdNumber": 3000005,
        "financialActivities": [
            {
                "activityTypeName": "Investment Banking/Underwriting",
                "activityTypeCode": "NVSMT_BANK_UNDRW"
            },
            {
                "activityTypeName": "Investment Advisory Services",
                "activityTypeCode": "NVSMT_ADVSR"
            },
            {
                "activityTypeName": "Investment Banking",
                "activityTypeCode": "NVSMT_BANK"
            },
            {
                "activityTypeName": "Sales - Institutional",
                "activityTypeCode": "SALES_INSTL"
            },
            {
                "activityTypeName": "Sales",
                "activityTypeCode": "SALES"
            }
        ],
        "branchCrdNumber": null
    },
    {
        "branchAddress": {
            "stateCode": "MS"
        },
        "firmCrdNumber": 3000005,
        "financialActivities": [
            {
                "activityTypeName": "Underwriting",
                "activityTypeCode": "UNDRW"
            },
            {
                "activityTypeName": "Investment Advisory Services",
                "activityTypeCode": "NVSMT_ADVSR"
            },
            {
                "activityTypeName": "Sales - Retail",
                "activityTypeCode": "SALES_RTL"
            }
        ],
        "branchCrdNumber": 50002
    },
    {
        "branchAddress": {
            "stateCode": "CA"
        },
        "firmCrdNumber": 3000005,
        "financialActivities": [
            {
                "activityTypeName": "Investment Advisory Services",
                "activityTypeCode": "NVSMT_ADVSR"
            },
            {
                "activityTypeName": "Back Office Operations",
                "activityTypeCode": "BCK_OFC"
            },
            {
                "activityTypeName": "Sales - Institutional",
                "activityTypeCode": "SALES_INSTL"
            },
            {
                "activityTypeName": "Sales",
                "activityTypeCode": "SALES"
            }
        ],
        "branchCrdNumber": null
    },
    {
        "branchAddress": {
            "stateCode": "MO"
        },
        "firmCrdNumber": 3000005,
        "financialActivities": [
            {
                "activityTypeName": "Other",
                "activityTypeCode": "OTHER"
            },
            {
                "activityTypeName": "Investment Advisory Services",
                "activityTypeCode": "NVSMT_ADVSR"
            },
            {
                "activityTypeName": "Public Finance",
                "activityTypeCode": "PBLC_FNNC"
            },
            {
                "activityTypeName": "Sales - Institutional",
                "activityTypeCode": "SALES_INSTL"
            }
        ],
        "branchCrdNumber": 50003
    },
    {
        "branchAddress": {
            "stateCode": "GA"
        },
        "firmCrdNumber": 3000005,
        "financialActivities": [
            {
                "activityTypeName": "Other",
                "activityTypeCode": "OTHER"
            },
            {
                "activityTypeName": "Underwriting",
                "activityTypeCode": "UNDRW"
            },
            {
                "activityTypeName": "Sales - Retail",
                "activityTypeCode": "SALES_RTL"
            },
            {
                "activityTypeName": "Back Office Operations",
                "activityTypeCode": "BCK_OFC"
            },
            {
                "activityTypeName": "Research",
                "activityTypeCode": "RSRCH"
            }
        ],
        "branchCrdNumber": null
    }
]

 

Sample Request
https://api.finra.org/data/group/firm/name/branchOfficeFinancialActivitiesMock

 

Sample Request Payload
{
"limit":5,
"compareFilters": [ 
{"compareType": "equal", "fieldName": "financialActivities.activityTypeCode", "fieldValue": "SALES" }
]
}
 

 

Sample Response
[
    {
        "branchAddress": {
            "stateCode": "MO"
        },
        "firmCrdNumber": 3000005,
        "financialActivities": [
            {
                "activityTypeName": "Sales",
                "activityTypeCode": "SALES"
            }
        ],
        "branchCrdNumber": null
    },
    {
        "branchAddress": {
            "stateCode": "CA"
        },
        "firmCrdNumber": 3000005,
        "financialActivities": [
            {
                "activityTypeName": "Sales",
                "activityTypeCode": "SALES"
            }
        ],
        "branchCrdNumber": null
    },
    {
        "branchAddress": {
            "stateCode": "KY"
        },
        "firmCrdNumber": 3000005,
        "financialActivities": [
            {
                "activityTypeName": "Sales",
                "activityTypeCode": "SALES"
            }
        ],
        "branchCrdNumber": null
    },
    {
        "branchAddress": {
            "stateCode": "WV"
        },
        "firmCrdNumber": 3000005,
        "financialActivities": [
            {
                "activityTypeName": "Sales",
                "activityTypeCode": "SALES"
            }
        ],
        "branchCrdNumber": null
    },
    {
        "branchAddress": {
            "stateCode": "VT"
        },
        "firmCrdNumber": 3000005,
        "financialActivities": [
            {
                "activityTypeName": "Sales",
                "activityTypeCode": "SALES"
            }
        ],
        "branchCrdNumber": null
    }
]

 

Branch Office Locations

Location information for each branch associated with a firm.

Dataset Info:

group dataset test dataset
firm branchOfficeLocations branchOfficeLocationsMock

 

Sample Request
https://api.finra.org/data/group/firm/name/branchOfficeLocationsMock?limit=5

 

Sample Response
[
    {
        "branchAddress": {
            "cityName": "Alexandria",
            "stateName": "Missouri",
            "countryCode": "USA",
            "postalCode": "78522",
            "addressLine1": "3686 Annett",
            "addressLine2": null,
            "stateCode": "MO",
            "countryName": "United States of America"
        },
        "firmCrdNumber": 3000005,
        "branchCrdNumber": null
    },
    {
        "branchAddress": {
            "cityName": "Normal",
            "stateName": "Mississippi",
            "countryCode": "USA",
            "postalCode": "20049",
            "addressLine1": "7027 Berkenshire",
            "addressLine2": null,
            "stateCode": "MS",
            "countryName": "United States of America"
        },
        "firmCrdNumber": 3000005,
        "branchCrdNumber": 50002
    },
    {
        "branchAddress": {
            "cityName": "Lewisville",
            "stateName": "California",
            "countryCode": "USA",
            "postalCode": "49622",
            "addressLine1": "9532 British Colony",
            "addressLine2": "APT 1554",
            "stateCode": "CA",
            "countryName": "United States of America"
        },
        "firmCrdNumber": 3000005,
        "branchCrdNumber": null
    },
    {
        "branchAddress": {
            "cityName": "Milwaukee",
            "stateName": "Missouri",
            "countryCode": "USA",
            "postalCode": "46889",
            "addressLine1": "3299 Loren",
            "addressLine2": null,
            "stateCode": "MO",
            "countryName": "United States of America"
        },
        "firmCrdNumber": 3000005,
        "branchCrdNumber": 50003
    },
    {
        "branchAddress": {
            "cityName": "Columbia",
            "stateName": "Georgia",
            "countryCode": "USA",
            "postalCode": "82940",
            "addressLine1": "377 Drew Lake",
            "addressLine2": null,
            "stateCode": "GA",
            "countryName": "United States of America"
        },
        "firmCrdNumber": 3000005,
        "branchCrdNumber": null
    }
]

 

Sample Request
https://api.finra.org/data/group/firm/name/branchOfficeLocationsMock

 

Sample Request Payload
{
"limit":5,
"fields":["branchCrdNumber","branchAddress.addressLine1","branchAddress.addressLine2","branchAddress.cityName","branchAddress.postalCode"],
"compareFilters": [ 
{"compareType": "equal", "fieldName": "branchAddress.stateCode", "fieldValue": "CA" }
]
}
 

 

Sample Response
[
    {
        "branchAddress": {
            "cityName": "Lewisville",
            "postalCode": "49622",
            "addressLine1": "9532 British Colony",
            "addressLine2": "APT 1554"
        },
        "branchCrdNumber": null
    },
    {
        "branchAddress": {
            "cityName": "Youngstown",
            "postalCode": "15578",
            "addressLine1": "7599 Case",
            "addressLine2": "APT 840"
        },
        "branchCrdNumber": 50043
    },
    {
        "branchAddress": {
            "cityName": "Evansville",
            "postalCode": "48786",
            "addressLine1": "820 Stanhope Park",
            "addressLine2": "APT 1393"
        },
        "branchCrdNumber": 50075
    },
    {
        "branchAddress": {
            "cityName": "Concord",
            "postalCode": "46281",
            "addressLine1": "7660 S Major"
        },
        "branchCrdNumber": 50120
    },
    {
        "branchAddress": {
            "cityName": "Newport News",
            "postalCode": "65525",
            "addressLine1": "6341 Broad Brook"
        },
        "branchCrdNumber": null
    }
]

 

Branch Office Registrations

Registration information for each branch.

Dataset Info:

group dataset test dataset
firm branchOfficeRegistrations branchOfficeRegistrationsMock

 

Sample Request
https://api.finra.org/data/group/firm/name/branchOfficeRegistrationsMock?limit=5

 

Sample Response
[
    {
        "registrations": [
            {
                "isCurrent": "YES",
                "jurisdiction": "UoZQPUzHuW",
                "effectiveDate": "1992-04-23",
                "statusCode": "closed"
            }
        ],
        "branchAddress": {
            "stateCode": "MO"
        },
        "firmCrdNumber": 3000005,
        "branchCrdNumber": null
    },
    {
        "registrations": [
            {
                "isCurrent": "NO",
                "jurisdiction": "yNAINZlgGc",
                "effectiveDate": "2000-05-24",
                "statusCode": "open"
            }
        ],
        "branchAddress": {
            "stateCode": "MS"
        },
        "firmCrdNumber": 3000005,
        "branchCrdNumber": 50002
    },
    {
        "branchAddress": {
            "stateCode": "CA"
        },
        "firmCrdNumber": 3000005,
        "branchCrdNumber": null
    },
    {
        "registrations": [
            {
                "isCurrent": "YES",
                "jurisdiction": "ESEoQpKskl",
                "effectiveDate": "2005-02-02",
                "statusCode": "closed"
            }
        ],
        "branchAddress": {
            "stateCode": "MO"
        },
        "firmCrdNumber": 3000005,
        "branchCrdNumber": 50003
    },
    {
        "branchAddress": {
            "stateCode": "GA"
        },
        "firmCrdNumber": 3000005,
        "branchCrdNumber": null
    }
]

 

Sample Request
https://api.finra.org/data/group/firm/name/branchOfficeRegistrationsMock

 

Sample Request Payload
{
"limit":5,
"compareFilters": [ 
{"compareType": "equal", "fieldName": "registrations.isCurrent", "fieldValue": "YES" }
]
}
 

 

Sample Response
[
    {
        "registrations": [
            {
                "isCurrent": "YES",
                "jurisdiction": "UoZQPUzHuW",
                "effectiveDate": "1992-04-23",
                "statusCode": "closed"
            }
        ],
        "branchAddress": {
            "stateCode": "MO"
        },
        "firmCrdNumber": 3000005,
        "branchCrdNumber": null
    },
    {
        "registrations": [
            {
                "isCurrent": "YES",
                "jurisdiction": "ESEoQpKskl",
                "effectiveDate": "2005-02-02",
                "statusCode": "closed"
            }
        ],
        "branchAddress": {
            "stateCode": "MO"
        },
        "firmCrdNumber": 3000005,
        "branchCrdNumber": 50003
    },
    {
        "registrations": [
            {
                "isCurrent": "YES",
                "jurisdiction": "esPwbpMCpL",
                "effectiveDate": "1979-02-08",
                "statusCode": "closed"
            }
        ],
        "branchAddress": {
            "stateCode": "MN"
        },
        "firmCrdNumber": 3000005,
        "branchCrdNumber": 50005
    },
    {
        "registrations": [
            {
                "isCurrent": "YES",
                "jurisdiction": "sFVrxdobaU",
                "effectiveDate": "2014-12-08",
                "statusCode": "approved"
            }
        ],
        "branchAddress": {
            "stateCode": "MI"
        },
        "firmCrdNumber": 3000005,
        "branchCrdNumber": 50006
    },
    {
        "registrations": [
            {
                "isCurrent": "YES",
                "jurisdiction": "pyKDcVIYfF",
                "effectiveDate": "2007-12-01",
                "statusCode": "approved"
            }
        ],
        "branchAddress": {
            "stateCode": "MT"
        },
        "firmCrdNumber": 3000005,
        "branchCrdNumber": null
    }
]

 

Continuing Education

Continuing education status information for registered individuals.

Dataset Info:

group dataset test dataset
firm registeredIndividualContinuingEducation registeredIndividualContinuingEducationMock

 

Sample Request
https://api.finra.org/data/group/firm/name/registeredIndividualContinuingEducationMock?limit=5

 

Sample Response
[
    {
        "ceStatusDate": "2021-01-14",
        "registrations": [
            {
                "regulatorCode": "NQX"
            },
            {
                "regulatorCode": "NYSE-AMER"
            }
        ],
        "militaryAnnualVerificationReceivedFlag": "NO",
        "ceStatus": "CE Inactive",
        "militaryDutyBeginDate": null,
        "employments": [
            {
                "firmCrdNumber": 3000005
            }
        ],
        "individualCrdNumber": 1,
        "ceBaseDate": "2017-07-14",
        "militaryDeferredFlag": "NO",
        "ceSessions": [
            {
                "appointmentStatusCode": null,
                "sessionTypeName": "Registered Representative Session",
                "requirementTypeName": "Anniversary",
                "appointmentProgress": null,
                "windowBeginDate": "2021-01-14",
                "onlineLastAccessedDate": "2021-01-24",
                "windowEndDate": "2021-05-14"
            }
        ]
    },
    {
        "ceStatusDate": null,
        "registrations": [
            {
                "regulatorCode": "NYSE-AMER"
            },
            {
                "regulatorCode": "NQX"
            }
        ],
        "militaryAnnualVerificationReceivedFlag": "NO",
        "ceStatus": null,
        "militaryDutyBeginDate": null,
        "employments": [
            {
                "firmCrdNumber": 3000005
            }
        ],
        "individualCrdNumber": 10,
        "ceBaseDate": null,
        "militaryDeferredFlag": "YES"
    },
    {
        "ceStatusDate": null,
        "registrations": [
            {
                "regulatorCode": "CBOE C2"
            },
            {
                "regulatorCode": "MEMX"
            }
        ],
        "militaryAnnualVerificationReceivedFlag": "YES",
        "ceStatus": null,
        "militaryDutyBeginDate": "2006-03-24",
        "employments": [
            {
                "firmCrdNumber": 3000005
            }
        ],
        "individualCrdNumber": 100,
        "ceBaseDate": null,
        "militaryDeferredFlag": "NO"
    },
    {
        "ceStatusDate": null,
        "registrations": [
            {
                "regulatorCode": "MIAX OPTIONS"
            },
            {
                "regulatorCode": "NYSE-AMER"
            }
        ],
        "militaryAnnualVerificationReceivedFlag": "YES",
        "ceStatus": null,
        "militaryDutyBeginDate": "2017-11-04",
        "employments": [
            {
                "firmCrdNumber": 3000005
            }
        ],
        "individualCrdNumber": 1000,
        "ceBaseDate": null,
        "militaryDeferredFlag": "NO"
    },
    {
        "ceStatusDate": null,
        "registrations": [
            {
                "regulatorCode": "NYSE-CHI"
            },
            {
                "regulatorCode": "HI"
            }
        ],
        "militaryAnnualVerificationReceivedFlag": "NO",
        "ceStatus": null,
        "militaryDutyBeginDate": null,
        "employments": [
            {
                "firmCrdNumber": 3000005
            },
            {
                "firmCrdNumber": 3000005
            }
        ],
        "individualCrdNumber": 10000,
        "ceBaseDate": null,
        "militaryDeferredFlag": "NO"
    }
]

 

Sample Request
https://api.finra.org/data/group/firm/name/registeredIndividualContinuingEducationMock

 

Sample Request Payload
{
"limit":5,
"compareFilters": [ 
{"compareType": "equal", "fieldName": "registrations.regulatorCode", "fieldValue": "CBOE C2" }
]
}
 

 

Sample Response
[
    {
        "ceStatusDate": null,
        "registrations": [
            {
                "regulatorCode": "CBOE C2"
            }
        ],
        "militaryAnnualVerificationReceivedFlag": "YES",
        "ceStatus": null,
        "militaryDutyBeginDate": "2006-03-24",
        "employments": [
            {
                "firmCrdNumber": 3000005
            }
        ],
        "individualCrdNumber": 100,
        "ceBaseDate": null,
        "militaryDeferredFlag": "NO"
    },
    {
        "ceStatusDate": null,
        "registrations": [
            {
                "regulatorCode": "CBOE C2"
            }
        ],
        "militaryAnnualVerificationReceivedFlag": "YES",
        "ceStatus": null,
        "militaryDutyBeginDate": "2012-08-05",
        "employments": [
            {
                "firmCrdNumber": 3000005
            },
            {
                "firmCrdNumber": 3000005
            }
        ],
        "individualCrdNumber": 114,
        "ceBaseDate": null,
        "militaryDeferredFlag": "YES"
    },
    {
        "ceStatusDate": null,
        "registrations": [
            {
                "regulatorCode": "CBOE C2"
            }
        ],
        "militaryAnnualVerificationReceivedFlag": "YES",
        "ceStatus": null,
        "militaryDutyBeginDate": "1970-11-14",
        "employments": [
            {
                "firmCrdNumber": 3000005
            },
            {
                "firmCrdNumber": 3000005
            }
        ],
        "individualCrdNumber": 1162,
        "ceBaseDate": null,
        "militaryDeferredFlag": "NO"
    },
    {
        "ceStatusDate": null,
        "registrations": [
            {
                "regulatorCode": "CBOE C2"
            }
        ],
        "militaryAnnualVerificationReceivedFlag": "NO",
        "ceStatus": null,
        "militaryDutyBeginDate": null,
        "employments": [
            {
                "firmCrdNumber": 3000005
            },
            {
                "firmCrdNumber": 3000005
            }
        ],
        "individualCrdNumber": 1199,
        "ceBaseDate": null,
        "militaryDeferredFlag": "YES"
    },
    {
        "ceStatusDate": "2021-01-14",
        "registrations": [
            {
                "regulatorCode": "CBOE C2"
            }
        ],
        "militaryAnnualVerificationReceivedFlag": "NO",
        "ceStatus": "CE 2 Year Termed",
        "militaryDutyBeginDate": null,
        "employments": [
            {
                "firmCrdNumber": 3000005
            }
        ],
        "individualCrdNumber": 1201,
        "ceBaseDate": "2014-01-14",
        "militaryDeferredFlag": "NO",
        "ceSessions": [
            {
                "appointmentStatusCode": null,
                "sessionTypeName": null,
                "requirementTypeName": null,
                "appointmentProgress": null,
                "windowBeginDate": null,
                "onlineLastAccessedDate": null,
                "windowEndDate": null
            }
        ]
    }
]

 

Deficiencies

Registration deficiency information for registered individuals including regulator identification.

Dataset Info:

group dataset test dataset
firm registeredIndividualDeficiencies registeredIndividualDeficienciesMock

 

Sample Request
https://api.finra.org/data/group/firm/name/registeredIndividualDeficienciesMock?limit=5

 

Sample Response
[
    {
        "registrations": [
            {
                "regulatorCode": "NQX"
            },
            {
                "regulatorCode": "NYSE-AMER"
            }
        ],
        "individualCrdNumber": 1
    },
    {
        "registrations": [
            {
                "regulatorCode": "NYSE-AMER"
            },
            {
                "regulatorCode": "NQX"
            }
        ],
        "individualCrdNumber": 10
    },
    {
        "registrations": [
            {
                "regulatorCode": "CBOE C2"
            },
            {
                "regulatorCode": "MEMX"
            }
        ],
        "deficiencies": [
            {
                "regulatorName": "FINRA",
                "examCode": null,
                "deficiencyType": null,
                "registrationCategoryCode": null,
                "deficiencyDate": null,
                "regulatorCode": "WL",
                "firmCrdNumber": 3000005
            },
            {
                "regulatorName": "FL",
                "examCode": null,
                "deficiencyType": null,
                "registrationCategoryCode": null,
                "deficiencyDate": null,
                "regulatorCode": "FL",
                "firmCrdNumber": 3000005
            }
        ],
        "individualCrdNumber": 100
    },
    {
        "registrations": [
            {
                "regulatorCode": "MIAX OPTIONS"
            },
            {
                "regulatorCode": "NYSE-AMER"
            }
        ],
        "deficiencies": [
            {
                "regulatorName": "NYSE-NAT",
                "examCode": null,
                "deficiencyType": null,
                "registrationCategoryCode": null,
                "deficiencyDate": null,
                "regulatorCode": "VA",
                "firmCrdNumber": 3000005
            }
        ],
        "individualCrdNumber": 1000
    },
    {
        "registrations": [
            {
                "regulatorCode": "NYSE-CHI"
            },
            {
                "regulatorCode": "HI"
            }
        ],
        "individualCrdNumber": 10000
    }
]

 

Sample Request
https://api.finra.org/data/group/firm/name/registeredIndividualDeficienciesMock

 

Sample Request Payload
{
"limit":5,
"compareFilters": [ 
{"compareType": "equal", "fieldName": "deficiencies.regulatorName", "fieldValue": "NYSE-NAT" }
]
}
 

 

Sample Response
[
    {
        "registrations": [
            {
                "regulatorCode": "MIAX OPTIONS"
            },
            {
                "regulatorCode": "NYSE-AMER"
            }
        ],
        "deficiencies": [
            {
                "regulatorName": "NYSE-NAT",
                "examCode": null,
                "deficiencyType": null,
                "registrationCategoryCode": null,
                "deficiencyDate": null,
                "regulatorCode": "VA",
                "firmCrdNumber": "3000005"
            }
        ],
        "individualCrdNumber": 1000
    },
    {
        "registrations": [
            {
                "regulatorCode": "CBOE EDGX"
            },
            {
                "regulatorCode": "FINRA"
            }
        ],
        "deficiencies": [
            {
                "regulatorName": "NYSE-NAT",
                "examCode": null,
                "deficiencyType": null,
                "registrationCategoryCode": null,
                "deficiencyDate": null,
                "regulatorCode": "FINRA",
                "firmCrdNumber": "3000005"
            }
        ],
        "individualCrdNumber": 1005
    },
    {
        "registrations": [
            {
                "regulatorCode": "MEMX"
            },
            {
                "regulatorCode": "ISE MRX"
            }
        ],
        "deficiencies": [
            {
                "regulatorName": "NYSE-NAT",
                "examCode": null,
                "deficiencyType": null,
                "registrationCategoryCode": null,
                "deficiencyDate": null,
                "regulatorCode": "VA",
                "firmCrdNumber": "3000005"
            }
        ],
        "individualCrdNumber": 1016
    },
    {
        "registrations": [
            {
                "regulatorCode": "NYSE-CHI"
            },
            {
                "regulatorCode": "NYSE-NAT"
            }
        ],
        "deficiencies": [
            {
                "regulatorName": "NYSE-NAT",
                "examCode": null,
                "deficiencyType": null,
                "registrationCategoryCode": null,
                "deficiencyDate": null,
                "regulatorCode": "WL",
                "firmCrdNumber": "3000005"
            }
        ],
        "individualCrdNumber": 1018
    },
    {
        "registrations": [
            {
                "regulatorCode": "CBOE BZX"
            },
            {
                "regulatorCode": "CBOE BZX"
            }
        ],
        "deficiencies": [
            {
                "regulatorName": "NYSE-NAT",
                "examCode": null,
                "deficiencyType": null,
                "registrationCategoryCode": null,
                "deficiencyDate": null,
                "regulatorCode": "FINRA",
                "firmCrdNumber": "3000005"
            }
        ],
        "individualCrdNumber": 1030
    }
]

 

Disclosure

Disclosure information for registered individuals including disclosure type.

Dataset Info:

group dataset test dataset
firm registeredIndividualDisclosures registeredIndividualDisclosuresMock

 

Sample Request
https://api.finra.org/data/group/firm/name/registeredIndividualDisclosuresMock?limit=5

 

Sample Response
[
    {
        "registrations": [
            {
                "regulatorCode": "NQX"
            },
            {
                "regulatorCode": "NYSE-AMER"
            }
        ],
        "employments": [
            {
                "firmCrdNumber": 3000005
            }
        ],
        "individualCrdNumber": 1
    },
    {
        "registrations": [
            {
                "regulatorCode": "NYSE-AMER"
            },
            {
                "regulatorCode": "NQX"
            }
        ],
        "employments": [
            {
                "firmCrdNumber": 3000005
            }
        ],
        "disclosures": [
            {
                "disclosureType": "Termination",
                "reportableFlag": "YES",
                "publiclyDisclosableFlag": null,
                "occurrenceNumber": 4957733874,
                "amendableFlag": "YES",
                "disclosableFlag": "YES",
                "archivedFlag": null
            }
        ],
        "individualCrdNumber": 10
    },
    {
        "registrations": [
            {
                "regulatorCode": "CBOE C2"
            },
            {
                "regulatorCode": "MEMX"
            }
        ],
        "employments": [
            {
                "firmCrdNumber": 3000005
            }
        ],
        "disclosures": [
            {
                "disclosureType": "Judgment/Lien",
                "reportableFlag": "YES",
                "publiclyDisclosableFlag": null,
                "occurrenceNumber": 5650482209,
                "amendableFlag": "NO",
                "disclosableFlag": "YES",
                "archivedFlag": null
            }
        ],
        "individualCrdNumber": 100
    },
    {
        "registrations": [
            {
                "regulatorCode": "MIAX OPTIONS"
            },
            {
                "regulatorCode": "NYSE-AMER"
            }
        ],
        "employments": [
            {
                "firmCrdNumber": 3000005
            }
        ],
        "disclosures": [
            {
                "disclosureType": "Civil Judicial Action",
                "reportableFlag": "YES",
                "publiclyDisclosableFlag": null,
                "occurrenceNumber": 5338275277,
                "amendableFlag": "NO",
                "disclosableFlag": "NO",
                "archivedFlag": null
            }
        ],
        "individualCrdNumber": 1000
    },
    {
        "registrations": [
            {
                "regulatorCode": "NYSE-CHI"
            },
            {
                "regulatorCode": "HI"
            }
        ],
        "employments": [
            {
                "firmCrdNumber": 3000005
            },
            {
                "firmCrdNumber": 3000005
            }
        ],
        "individualCrdNumber": 10000
    }
]

 

Sample Request
https://api.finra.org/data/group/firm/name/registeredIndividualDisclosuresMock

 

Sample Request Payload
{
"limit":5,
"fields":["disclosures.disclosureType","disclosures.reportableFlag","employments.firmCRDNumber"]
}
 

 

Sample Response
[
    {
        "employments": [
            {
                "firmCrdNumber": 3000005
            }
        ]
    },
    {
        "employments": [
            {
                "firmCrdNumber": 3000005
            }
        ],
        "disclosures": [
            {
                "disclosureType": "Termination",
                "reportableFlag": "YES"
            }
        ]
    },
    {
        "employments": [
            {
                "firmCrdNumber": 3000005
            }
        ],
        "disclosures": [
            {
                "disclosureType": "Judgment/Lien",
                "reportableFlag": "YES"
            }
        ]
    },
    {
        "employments": [
            {
                "firmCrdNumber": 3000005
            }
        ],
        "disclosures": [
            {
                "disclosureType": "Civil Judicial Action",
                "reportableFlag": "YES"
            }
        ]
    },
    {
        "employments": [
            {
                "firmCrdNumber": 3000005
            },
            {
                "firmCrdNumber": 3000005
            }
        ]
    }
]

 

Disclosure Filings

Disclosure filings for a registered individual.

Dataset Info:

group dataset test dataset
firm registeredIndividualDisclosureFilings registeredIndividualDisclosureFilingsMock

 

Sample Request
https://api.finra.org/data/group/firm/name/registeredIndividualDisclosureFilingsMock?limit=5

 

Sample Response
[
    {
        "registrations": [
            {
                "regulatorCode": "NQX"
            },
            {
                "regulatorCode": "NYSE-AMER"
            }
        ],
        "employments": [
            {
                "firmCrdNumber": 3000005
            }
        ],
        "individualCrdNumber": 1
    },
    {
        "registrations": [
            {
                "regulatorCode": "NYSE-AMER"
            },
            {
                "regulatorCode": "NQX"
            }
        ],
        "employments": [
            {
                "firmCrdNumber": 3000005
            }
        ],
        "individualCrdNumber": 10,
        "disclosureFilings": [
            {
                "disclosureTypeCode": "Termination",
                "formTypeCode": "U5",
                "statusDate": "2017-06-10",
                "filingNumber": 8099057302,
                "comments": null,
                "filedByFirmName": "EQIS SECURITIES, LLC",
                "filedByRegulatorName": null,
                "filingDate": "2014-03-15",
                "occurrenceNumber": 4957733874,
                "pending": "YES",
                "firstReportedDate": "2014-03-15",
                "disclosureTypeName": "termination",
                "filedByRegulatorCode": null,
                "disclosureStatus": "PENDING",
                "amendableFlag": "YES",
                "filedByRegulatorNumber": null,
                "employingFirmName": "EQIS SECURITIES, LLC",
                "filingTypeCode": "AMENDMENT",
                "allegations": "FAIR PRACTICE ALLEGEDLY VIOLATED ARTICLE III SECITON 1, 12 AND 19D.",
                "filedByFirmCrdNumber": 20633,
                "allegedDamages": null,
                "eventDate": "2013-12-14",
                "satisfies4530Filing": null
            },
            {
                "disclosureTypeCode": "Termination",
                "formTypeCode": "U5",
                "statusDate": "2021-06-11",
                "filingNumber": 8112899519,
                "comments": null,
                "filedByFirmName": "JMI SECURITIES CORPORATION",
                "filedByRegulatorName": null,
                "filingDate": "2021-05-16",
                "occurrenceNumber": 4957733874,
                "pending": "NO",
                "firstReportedDate": "2021-05-16",
                "disclosureTypeName": "termination",
                "filedByRegulatorCode": null,
                "disclosureStatus": "FINAL",
                "amendableFlag": "NO",
                "filedByRegulatorNumber": null,
                "employingFirmName": "JMI SECURITIES CORPORATION",
                "filingTypeCode": "AMENDMENT",
                "allegations": "FAIR PRACTICE ALLEGEDLY VIOLATED ARTICLE III SECITON 1, 12 AND 19D.",
                "filedByFirmCrdNumber": 13955,
                "allegedDamages": null,
                "eventDate": "2021-05-14",
                "satisfies4530Filing": null
            },
            {
                "disclosureTypeCode": "Termination",
                "formTypeCode": "U6",
                "statusDate": "2017-03-19",
                "filingNumber": 9893513669,
                "comments": null,
                "filedByFirmName": "COTTON AND ASSOCIATES, C.L.P.",
                "filedByRegulatorName": null,
                "filingDate": "2013-10-18",
                "occurrenceNumber": 4957733874,
                "pending": "NO",
                "firstReportedDate": "2013-10-18",
                "disclosureTypeName": "termination",
                "filedByRegulatorCode": null,
                "disclosureStatus": "FINAL",
                "amendableFlag": "NO",
                "filedByRegulatorNumber": null,
                "employingFirmName": "COTTON AND ASSOCIATES, C.L.P.",
                "filingTypeCode": "AMENDMENT",
                "allegations": "NASD QUESTIONED USE OF ADVERTISING MATERIAL FOR A SEMINAR BEING GIVEN BY ONE OF THE ACCOUNT EXECUTIVES IN REGION OVER WHICH I WAS RESPONSIBLE.",
                "filedByFirmCrdNumber": 37390,
                "allegedDamages": null,
                "eventDate": "2013-07-14",
                "satisfies4530Filing": null
            },
            {
                "disclosureTypeCode": "Termination",
                "formTypeCode": "U5",
                "statusDate": "2017-06-27",
                "filingNumber": 2405278696,
                "comments": null,
                "filedByFirmName": "SEA COAST SECURITIES, INC",
                "filedByRegulatorName": null,
                "filingDate": "2014-04-14",
                "occurrenceNumber": 4957733874,
                "pending": "NO",
                "firstReportedDate": "2014-04-14",
                "disclosureTypeName": "termination",
                "filedByRegulatorCode": null,
                "disclosureStatus": "FINAL",
                "amendableFlag": "NO",
                "filedByRegulatorNumber": null,
                "employingFirmName": "SEA COAST SECURITIES, INC",
                "filingTypeCode": "AMENDMENT",
                "allegations": "FAIR PRACTICE ALLEGEDLY VIOLATED ARTICLE III SECITON 1, 12 AND 19D.",
                "filedByFirmCrdNumber": 10157,
                "allegedDamages": null,
                "eventDate": "2014-01-14",
                "satisfies4530Filing": null
            },
            {
                "disclosureTypeCode": "Termination",
                "formTypeCode": "U5",
                "statusDate": "2018-08-27",
                "filingNumber": 1841661748,
                "comments": null,
                "filedByFirmName": "BKD INSURANCE, LLC",
                "filedByRegulatorName": null,
                "filingDate": "2016-05-17",
                "occurrenceNumber": 4957733874,
                "pending": "NO",
                "firstReportedDate": "2016-05-17",
                "disclosureTypeName": "termination",
                "filedByRegulatorCode": null,
                "disclosureStatus": "FINAL",
                "amendableFlag": "NO",
                "filedByRegulatorNumber": null,
                "employingFirmName": "BKD INSURANCE, LLC",
                "filingTypeCode": "AMENDMENT",
                "allegations": "FALSE STATEMENT CHARGED REGARDING PREVIOUS DWI OF 10/12/71 MEDIA PA. CASE #30868",
                "filedByFirmCrdNumber": 42911,
                "allegedDamages": null,
                "eventDate": "2016-03-14",
                "satisfies4530Filing": null
            },
            {
                "disclosureTypeCode": "Termination",
                "formTypeCode": "U6",
                "statusDate": "2020-02-21",
                "filingNumber": 1925245862,
                "comments": null,
                "filedByFirmName": "JJONES, LLC",
                "filedByRegulatorName": null,
                "filingDate": "2019-01-14",
                "occurrenceNumber": 4957733874,
                "pending": "YES",
                "firstReportedDate": "2019-01-14",
                "disclosureTypeName": "termination",
                "filedByRegulatorCode": null,
                "disclosureStatus": "PENDING",
                "amendableFlag": "YES",
                "filedByRegulatorNumber": null,
                "employingFirmName": "JJONES, LLC",
                "filingTypeCode": "AMENDMENT",
                "allegations": "FAILURE TO HONOR AWARD IN ARBITRATION #89-00377 IN THE AMOUNT OF $67,556.02",
                "filedByFirmCrdNumber": 130315,
                "allegedDamages": null,
                "eventDate": "2018-12-14",
                "satisfies4530Filing": null
            }
        ]
    },
    {
        "registrations": [
            {
                "regulatorCode": "CBOE C2"
            },
            {
                "regulatorCode": "MEMX"
            }
        ],
        "employments": [
            {
                "firmCrdNumber": 3000005
            }
        ],
        "individualCrdNumber": 100,
        "disclosureFilings": [
            {
                "disclosureTypeCode": "Judgment/Lien",
                "formTypeCode": "U4",
                "statusDate": "2018-05-21",
                "filingNumber": 6668885611,
                "comments": null,
                "filedByFirmName": "KENNY SECURITIES CORP.",
                "filedByRegulatorName": null,
                "filingDate": "2015-11-23",
                "occurrenceNumber": 5650482209,
                "pending": "NO",
                "firstReportedDate": "2015-11-23",
                "disclosureTypeName": "judgment/lien",
                "filedByRegulatorCode": null,
                "disclosureStatus": "FINAL",
                "amendableFlag": "NO",
                "filedByRegulatorNumber": null,
                "employingFirmName": "KENNY SECURITIES CORP.",
                "filingTypeCode": "AMENDMENT",
                "allegations": "SEC RULE 15CE-1 WAS VIOLATED BY HAVING A NET CAPITAL DEFICIENCY ON 1-29-88 AND 2-29-88",
                "filedByFirmCrdNumber": 37552,
                "allegedDamages": null,
                "eventDate": "2015-09-14",
                "satisfies4530Filing": null
            },
            {
                "disclosureTypeCode": "Judgment/Lien",
                "formTypeCode": "U6",
                "statusDate": "2020-09-22",
                "filingNumber": 9256397981,
                "comments": null,
                "filedByFirmName": "MARKMAN SECURITIES, INC.",
                "filedByRegulatorName": null,
                "filingDate": "2020-02-01",
                "occurrenceNumber": 5650482209,
                "pending": "NO",
                "firstReportedDate": "2020-02-01",
                "disclosureTypeName": "judgment/lien",
                "filedByRegulatorCode": null,
                "disclosureStatus": "FINAL",
                "amendableFlag": "NO",
                "filedByRegulatorNumber": null,
                "employingFirmName": "MARKMAN SECURITIES, INC.",
                "filingTypeCode": "AMENDMENT",
                "allegations": "FAIR PRACTICE ALLEGEDLY VIOLATED ARTICLE III SECITON 1, 12 AND 19D.",
                "filedByFirmCrdNumber": 41505,
                "allegedDamages": null,
                "eventDate": "2020-01-14",
                "satisfies4530Filing": null
            },
            {
                "disclosureTypeCode": "Judgment/Lien",
                "formTypeCode": "U6",
                "statusDate": "2017-05-08",
                "filingNumber": 5874513102,
                "comments": null,
                "filedByFirmName": "BROKER XPRESS",
                "filedByRegulatorName": null,
                "filingDate": "2014-01-15",
                "occurrenceNumber": 5650482209,
                "pending": "YES",
                "firstReportedDate": "2014-01-15",
                "disclosureTypeName": "judgment/lien",
                "filedByRegulatorCode": null,
                "disclosureStatus": "PENDING",
                "amendableFlag": "YES",
                "filedByRegulatorNumber": null,
                "employingFirmName": "BROKER XPRESS",
                "filingTypeCode": "AMENDMENT",
                "allegations": "SEC RULE 15CE-1 WAS VIOLATED BY HAVING A NET CAPITAL DEFICIENCY ON 1-29-88 AND 2-29-88",
                "filedByFirmCrdNumber": 125921,
                "allegedDamages": null,
                "eventDate": "2013-10-14",
                "satisfies4530Filing": null
            },
            {
                "disclosureTypeCode": "Judgment/Lien",
                "formTypeCode": "U6",
                "statusDate": "2020-05-29",
                "filingNumber": 8243992803,
                "comments": null,
                "filedByFirmName": "STRASBOURGER PEARSON TULCIN WOLFF INCORPORATED",
                "filedByRegulatorName": null,
                "filingDate": "2019-07-09",
                "occurrenceNumber": 5650482209,
                "pending": "YES",
                "firstReportedDate": "2019-07-09",
                "disclosureTypeName": "judgment/lien",
                "filedByRegulatorCode": null,
                "disclosureStatus": "PENDING",
                "amendableFlag": "YES",
                "filedByRegulatorNumber": null,
                "employingFirmName": "STRASBOURGER PEARSON TULCIN WOLFF INCORPORATED",
                "filingTypeCode": "AMENDMENT",
                "allegations": "ALLEGED UNAUTHORIZED TRADES & WILFULLY VIOLATED SECTION 17 (A) OF THE SECURITIES EXCHANGE ACT OF 1934",
                "filedByFirmCrdNumber": 5133,
                "allegedDamages": null,
                "eventDate": "2019-06-14",
                "satisfies4530Filing": null
            },
            {
                "disclosureTypeCode": "Judgment/Lien",
                "formTypeCode": "U5",
                "statusDate": "2017-08-30",
                "filingNumber": 3220411742,
                "comments": null,
                "filedByFirmName": "WABASH VALLEY SPECIALISTS, INC.",
                "filedByRegulatorName": null,
                "filingDate": "2014-08-08",
                "occurrenceNumber": 5650482209,
                "pending": "NO",
                "firstReportedDate": "2014-08-08",
                "disclosureTypeName": "judgment/lien",
                "filedByRegulatorCode": null,
                "disclosureStatus": "FINAL",
                "amendableFlag": "NO",
                "filedByRegulatorNumber": null,
                "employingFirmName": "WABASH VALLEY SPECIALISTS, INC.",
                "filingTypeCode": "AMENDMENT",
                "allegations": "THE CBOE HAS CHARGED THAT DURING THE PERIOD FROM JUNE, 1988 THROUGH NOVEMBER, 1988 THAT PRUDENTIAL SECURITIES INCORPORATED AND MR. BALLAN FAILED TO ADEQUATELY SUPERVISE MR. JOHN S. CZIPRUSZ, WHO WAS A PRUDENTIAL REGISTERED REPRESENTATIVE, BY ALLOWING MR. CZIPRUSZ TO EFFECT OPTIONS TRANSACTIONS IN A CUSTOMER'S ACCOUNTS WHICH TRANSACTIONS WERE UNSUITABLE AND EXCESSIVE IN SIZE IN VIOLATION OF EXCHANGE RULE 4.2. (ADHERENCE TO LAW) AND 9.8 (SUPERVISION OF ACCOUNTS).",
                "filedByFirmCrdNumber": 41761,
                "allegedDamages": null,
                "eventDate": "2014-05-14",
                "satisfies4530Filing": null
            },
            {
                "disclosureTypeCode": "Judgment/Lien",
                "formTypeCode": "U4",
                "statusDate": "2018-06-23",
                "filingNumber": 2764543602,
                "comments": null,
                "filedByFirmName": "COHEN & STEERS SECURITIES, LLC",
                "filedByRegulatorName": null,
                "filingDate": "2016-01-21",
                "occurrenceNumber": 5650482209,
                "pending": "NO",
                "firstReportedDate": "2016-01-21",
                "disclosureTypeName": "judgment/lien",
                "filedByRegulatorCode": null,
                "disclosureStatus": "FINAL",
                "amendableFlag": "NO",
                "filedByRegulatorNumber": null,
                "employingFirmName": "COHEN & STEERS SECURITIES, LLC",
                "filingTypeCode": "AMENDMENT",
                "allegations": "ADAMS AND WHITNEY SECURITIES CORP AND THEODORE P. ALLOCCA REG. PRINCIPAL. VIOLATION OF S.E.C. RULE 15 C 3-3 AND S.E.C. RULE 17A-5, FAIR PRACTICE ALLEGEDLY VIOLATED ARTICLE III - SECTION I.",
                "filedByFirmCrdNumber": 29258,
                "allegedDamages": null,
                "eventDate": "2015-11-14",
                "satisfies4530Filing": null
            }
        ]
    },
    {
        "registrations": [
            {
                "regulatorCode": "MIAX OPTIONS"
            },
            {
                "regulatorCode": "NYSE-AMER"
            }
        ],
        "employments": [
            {
                "firmCrdNumber": 3000005
            }
        ],
        "individualCrdNumber": 1000,
        "disclosureFilings": [
            {
                "disclosureTypeCode": "Civil Judicial Action",
                "formTypeCode": "U6",
                "statusDate": "2017-06-10",
                "filingNumber": 520895659,
                "comments": null,
                "filedByFirmName": "MUSTANG TRADING, LLC",
                "filedByRegulatorName": null,
                "filingDate": "2014-03-15",
                "occurrenceNumber": 5338275277,
                "pending": "YES",
                "firstReportedDate": "2014-03-15",
                "disclosureTypeName": "civil judicial action",
                "filedByRegulatorCode": null,
                "disclosureStatus": "PENDING",
                "amendableFlag": "YES",
                "filedByRegulatorNumber": null,
                "employingFirmName": "MUSTANG TRADING, LLC",
                "filingTypeCode": "AMENDMENT",
                "allegations": "ALBANESE & CO. & EUGENE ALBANESE WAS CENSURED & FINED $10U0.00 &  SUSPENDED FROM ASSOCIATION WITH ANY MEMBER FOR A PERIOD OF TWO DAYS FOR VIOLATIONS OF REG T.",
                "filedByFirmCrdNumber": 131608,
                "allegedDamages": null,
                "eventDate": "2013-12-14",
                "satisfies4530Filing": null
            },
            {
                "disclosureTypeCode": "Civil Judicial Action",
                "formTypeCode": "U4",
                "statusDate": "2019-11-14",
                "filingNumber": 6866436553,
                "comments": null,
                "filedByFirmName": "ALTERNA CAPITAL CORP.",
                "filedByRegulatorName": null,
                "filingDate": "2018-07-21",
                "occurrenceNumber": 5338275277,
                "pending": "YES",
                "firstReportedDate": "2018-07-21",
                "disclosureTypeName": "civil judicial action",
                "filedByRegulatorCode": null,
                "disclosureStatus": "PENDING",
                "amendableFlag": "YES",
                "filedByRegulatorNumber": null,
                "employingFirmName": "ALTERNA CAPITAL CORP.",
                "filingTypeCode": "AMENDMENT",
                "allegations": "ALBANESE & CO. WERE CENSURED & FINED $100.00 FOR FILING A INACCURATE FINANCIAL STATEMENT.",
                "filedByFirmCrdNumber": 130233,
                "allegedDamages": null,
                "eventDate": "2018-06-14",
                "satisfies4530Filing": null
            },
            {
                "disclosureTypeCode": "Civil Judicial Action",
                "formTypeCode": "U4",
                "statusDate": "2018-05-21",
                "filingNumber": 7830760956,
                "comments": null,
                "filedByFirmName": "PETRA TRADING GROUP LLC",
                "filedByRegulatorName": null,
                "filingDate": "2015-11-23",
                "occurrenceNumber": 5338275277,
                "pending": "NO",
                "firstReportedDate": "2015-11-23",
                "disclosureTypeName": "civil judicial action",
                "filedByRegulatorCode": null,
                "disclosureStatus": "FINAL",
                "amendableFlag": "NO",
                "filedByRegulatorNumber": null,
                "employingFirmName": "PETRA TRADING GROUP LLC",
                "filingTypeCode": "AMENDMENT",
                "allegations": "FALSE STATEMENT CHARGED REGARDING PREVIOUS DWI OF 10/12/71 MEDIA PA. CASE #30868",
                "filedByFirmCrdNumber": 131347,
                "allegedDamages": null,
                "eventDate": "2015-09-14",
                "satisfies4530Filing": null
            },
            {
                "disclosureTypeCode": "Civil Judicial Action",
                "formTypeCode": "U6",
                "statusDate": "2017-04-05",
                "filingNumber": 5909684394,
                "comments": null,
                "filedByFirmName": "SHERIDAN TRADING COMPANY, LLC",
                "filedByRegulatorName": null,
                "filingDate": "2013-11-17",
                "occurrenceNumber": 5338275277,
                "pending": "YES",
                "firstReportedDate": "2013-11-17",
                "disclosureTypeName": "civil judicial action",
                "filedByRegulatorCode": null,
                "disclosureStatus": "PENDING",
                "amendableFlag": "YES",
                "filedByRegulatorNumber": null,
                "employingFirmName": "SHERIDAN TRADING COMPANY, LLC",
                "filingTypeCode": "AMENDMENT",
                "allegations": "ALLEGED UNAUTHORIZED TRADES & WILFULLY VIOLATED SECTION 17 (A) OF THE SECURITIES EXCHANGE ACT OF 1934",
                "filedByFirmCrdNumber": 125804,
                "allegedDamages": null,
                "eventDate": "2013-08-14",
                "satisfies4530Filing": null
            },
            {
                "disclosureTypeCode": "Civil Judicial Action",
                "formTypeCode": "U5",
                "statusDate": "2020-02-21",
                "filingNumber": 3377073673,
                "comments": null,
                "filedByFirmName": "MOODY FINANCIAL GROUP, INC.",
                "filedByRegulatorName": null,
                "filingDate": "2019-01-14",
                "occurrenceNumber": 5338275277,
                "pending": "YES",
                "firstReportedDate": "2019-01-14",
                "disclosureTypeName": "civil judicial action",
                "filedByRegulatorCode": null,
                "disclosureStatus": "PENDING",
                "amendableFlag": "YES",
                "filedByRegulatorNumber": null,
                "employingFirmName": "MOODY FINANCIAL GROUP, INC.",
                "filingTypeCode": "AMENDMENT",
                "allegations": "SEC RULE 15CE-1 WAS VIOLATED BY HAVING A NET CAPITAL DEFICIENCY ON 1-29-88 AND 2-29-88",
                "filedByFirmCrdNumber": 37646,
                "allegedDamages": null,
                "eventDate": "2018-12-14",
                "satisfies4530Filing": null
            },
            {
                "disclosureTypeCode": "Civil Judicial Action",
                "formTypeCode": "U5",
                "statusDate": "2021-02-01",
                "filingNumber": 9353299348,
                "comments": null,
                "filedByFirmName": "US EURO SECURITIES, INC",
                "filedByRegulatorName": null,
                "filingDate": "2020-09-24",
                "occurrenceNumber": 5338275277,
                "pending": "NO",
                "firstReportedDate": "2020-09-24",
                "disclosureTypeName": "civil judicial action",
                "filedByRegulatorCode": null,
                "disclosureStatus": "FINAL",
                "amendableFlag": "NO",
                "filedByRegulatorNumber": null,
                "employingFirmName": "US EURO SECURITIES, INC",
                "filingTypeCode": "AMENDMENT",
                "allegations": "FOUND TO HAVE VIOLATED PRINCIPLES OF N.Y.S.E. RULE 406(1), 408(a) & 440.",
                "filedByFirmCrdNumber": 38839,
                "allegedDamages": null,
                "eventDate": "2020-09-14",
                "satisfies4530Filing": null
            },
            {
                "disclosureTypeCode": "Civil Judicial Action",
                "formTypeCode": "U4",
                "statusDate": "2018-02-10",
                "filingNumber": 6791632487,
                "comments": null,
                "filedByFirmName": "BROCKINGTON SECURITIES, INC.",
                "filedByRegulatorName": null,
                "filingDate": "2015-05-29",
                "occurrenceNumber": 5338275277,
                "pending": "NO",
                "firstReportedDate": "2015-05-29",
                "disclosureTypeName": "civil judicial action",
                "filedByRegulatorCode": null,
                "disclosureStatus": "FINAL",
                "amendableFlag": "NO",
                "filedByRegulatorNumber": null,
                "employingFirmName": "BROCKINGTON SECURITIES, INC.",
                "filingTypeCode": "AMENDMENT",
                "allegations": "FAILURE TO COMPLY WITH FREE RIDING AND WITHHOLDING ARTICLE III SEC. I RULES OF FAIR PRACTICE IN CONNECTION WITH THE SALE OF 800 UNITS OF TOPOLOGIX. FINE 1500.00",
                "filedByFirmCrdNumber": 37438,
                "allegedDamages": null,
                "eventDate": "2015-03-14",
                "satisfies4530Filing": null
            },
            {
                "disclosureTypeCode": "Civil Judicial Action",
                "formTypeCode": "U6",
                "statusDate": "2021-03-06",
                "filingNumber": 1492885680,
                "comments": null,
                "filedByFirmName": "CAN-AM SECURITIES, INC.",
                "filedByRegulatorName": null,
                "filingDate": "2020-11-22",
                "occurrenceNumber": 5338275277,
                "pending": "NO",
                "firstReportedDate": "2020-11-22",
                "disclosureTypeName": "civil judicial action",
                "filedByRegulatorCode": null,
                "disclosureStatus": "FINAL",
                "amendableFlag": "NO",
                "filedByRegulatorNumber": null,
                "employingFirmName": "CAN-AM SECURITIES, INC.",
                "filingTypeCode": "AMENDMENT",
                "allegations": "THE CBOE HAS CHARGED THAT DURING THE PERIOD FROM JUNE, 1988 THROUGH NOVEMBER, 1988 THAT PRUDENTIAL SECURITIES INCORPORATED AND MR. BALLAN FAILED TO ADEQUATELY SUPERVISE MR. JOHN S. CZIPRUSZ, WHO WAS A PRUDENTIAL REGISTERED REPRESENTATIVE, BY ALLOWING MR. CZIPRUSZ TO EFFECT OPTIONS TRANSACTIONS IN A CUSTOMER'S ACCOUNTS WHICH TRANSACTIONS WERE UNSUITABLE AND EXCESSIVE IN SIZE IN VIOLATION OF EXCHANGE RULE 4.2. (ADHERENCE TO LAW) AND 9.8 (SUPERVISION OF ACCOUNTS).",
                "filedByFirmCrdNumber": 5160,
                "allegedDamages": null,
                "eventDate": "2020-11-14",
                "satisfies4530Filing": null
            },
            {
                "disclosureTypeCode": "Civil Judicial Action",
                "formTypeCode": "U6",
                "statusDate": "2019-07-23",
                "filingNumber": 7588634259,
                "comments": null,
                "filedByFirmName": "GEORGE WEISS & COMPANY LLC",
                "filedByRegulatorName": null,
                "filingDate": "2017-12-28",
                "occurrenceNumber": 5338275277,
                "pending": "NO",
                "firstReportedDate": "2017-12-28",
                "disclosureTypeName": "civil judicial action",
                "filedByRegulatorCode": null,
                "disclosureStatus": "FINAL",
                "amendableFlag": "NO",
                "filedByRegulatorNumber": null,
                "employingFirmName": "GEORGE WEISS & COMPANY LLC",
                "filingTypeCode": "AMENDMENT",
                "allegations": "ALLEGATIONS WERE AGAINST CAROLINA SECURITIES CORP. - NO INDIVIDUAL  PERSON WAS NAMED.",
                "filedByFirmCrdNumber": 41526,
                "allegedDamages": null,
                "eventDate": "2017-11-14",
                "satisfies4530Filing": null
            }
        ]
    },
    {
        "registrations": [
            {
                "regulatorCode": "NYSE-CHI"
            },
            {
                "regulatorCode": "HI"
            }
        ],
        "employments": [
            {
                "firmCrdNumber": 3000005
            },
            {
                "firmCrdNumber": 3000005
            }
        ],
        "individualCrdNumber": 10000
    }
]

 

Sample Request
https://api.finra.org/data/group/firm/name/registeredIndividualDisclosureFilingsMock

 

Sample Request Payload
{
"limit":5,
"fields":["issueSymbolIdentifier", "issueName", "totalWeeklyShareQuantity","totalWeeklyTradeCount","lastUpdateDate"],  
"compareFilters": [ 
{  "compareType": "equal", "fieldName": "tierIdentifier", "fieldValue": "T1" },
{  "compareType": "greater", "fieldName": "summaryStartDate", "fieldValue":"2019-09-01"},
{  "compareType": "equal", "fieldName": "summaryTypeCode", "fieldValue": "OTC_W_SMBL" },
{  "compareType": "equal", "fieldName": "issueSymbolIdentifier", "fieldValue" : "AAPL"}
]
}

 

Sample Response
[
    {
        "registrations": [
            {
                "regulatorCode": "MIAX OPTIONS"
            },
            {
                "regulatorCode": "NYSE-AMER"
            }
        ],
        "employments": [
            {
                "firmCrdNumber": 3000005
            }
        ],
        "individualCrdNumber": 1000,
        "disclosureFilings": [
            {
                "disclosureTypeCode": "Civil Judicial Action",
                "formTypeCode": "U6",
                "statusDate": "2017-06-10",
                "filingNumber": 520895659,
                "comments": null,
                "filedByFirmName": "MUSTANG TRADING, LLC",
                "filedByRegulatorName": null,
                "filingDate": "2014-03-15",
                "occurrenceNumber": 5338275277,
                "pending": "YES",
                "firstReportedDate": "2014-03-15",
                "disclosureTypeName": "civil judicial action",
                "filedByRegulatorCode": null,
                "disclosureStatus": "PENDING",
                "amendableFlag": "YES",
                "filedByRegulatorNumber": null,
                "employingFirmName": "MUSTANG TRADING, LLC",
                "filingTypeCode": "AMENDMENT",
                "allegations": "ALBANESE & CO. & EUGENE ALBANESE WAS CENSURED & FINED $10U0.00 &  SUSPENDED FROM ASSOCIATION WITH ANY MEMBER FOR A PERIOD OF TWO DAYS FOR VIOLATIONS OF REG T.",
                "filedByFirmCrdNumber": 131608,
                "allegedDamages": null,
                "eventDate": "2013-12-14",
                "satisfies4530Filing": null
            },
            {
                "disclosureTypeCode": "Civil Judicial Action",
                "formTypeCode": "U4",
                "statusDate": "2019-11-14",
                "filingNumber": 6866436553,
                "comments": null,
                "filedByFirmName": "ALTERNA CAPITAL CORP.",
                "filedByRegulatorName": null,
                "filingDate": "2018-07-21",
                "occurrenceNumber": 5338275277,
                "pending": "YES",
                "firstReportedDate": "2018-07-21",
                "disclosureTypeName": "civil judicial action",
                "filedByRegulatorCode": null,
                "disclosureStatus": "PENDING",
                "amendableFlag": "YES",
                "filedByRegulatorNumber": null,
                "employingFirmName": "ALTERNA CAPITAL CORP.",
                "filingTypeCode": "AMENDMENT",
                "allegations": "ALBANESE & CO. WERE CENSURED & FINED $100.00 FOR FILING A INACCURATE FINANCIAL STATEMENT.",
                "filedByFirmCrdNumber": 130233,
                "allegedDamages": null,
                "eventDate": "2018-06-14",
                "satisfies4530Filing": null
            },
            {
                "disclosureTypeCode": "Civil Judicial Action",
                "formTypeCode": "U4",
                "statusDate": "2018-05-21",
                "filingNumber": 7830760956,
                "comments": null,
                "filedByFirmName": "PETRA TRADING GROUP LLC",
                "filedByRegulatorName": null,
                "filingDate": "2015-11-23",
                "occurrenceNumber": 5338275277,
                "pending": "NO",
                "firstReportedDate": "2015-11-23",
                "disclosureTypeName": "civil judicial action",
                "filedByRegulatorCode": null,
                "disclosureStatus": "FINAL",
                "amendableFlag": "NO",
                "filedByRegulatorNumber": null,
                "employingFirmName": "PETRA TRADING GROUP LLC",
                "filingTypeCode": "AMENDMENT",
                "allegations": "FALSE STATEMENT CHARGED REGARDING PREVIOUS DWI OF 10/12/71 MEDIA PA. CASE #30868",
                "filedByFirmCrdNumber": 131347,
                "allegedDamages": null,
                "eventDate": "2015-09-14",
                "satisfies4530Filing": null
            },
            {
                "disclosureTypeCode": "Civil Judicial Action",
                "formTypeCode": "U6",
                "statusDate": "2017-04-05",
                "filingNumber": 5909684394,
                "comments": null,
                "filedByFirmName": "SHERIDAN TRADING COMPANY, LLC",
                "filedByRegulatorName": null,
                "filingDate": "2013-11-17",
                "occurrenceNumber": 5338275277,
                "pending": "YES",
                "firstReportedDate": "2013-11-17",
                "disclosureTypeName": "civil judicial action",
                "filedByRegulatorCode": null,
                "disclosureStatus": "PENDING",
                "amendableFlag": "YES",
                "filedByRegulatorNumber": null,
                "employingFirmName": "SHERIDAN TRADING COMPANY, LLC",
                "filingTypeCode": "AMENDMENT",
                "allegations": "ALLEGED UNAUTHORIZED TRADES & WILFULLY VIOLATED SECTION 17 (A) OF THE SECURITIES EXCHANGE ACT OF 1934",
                "filedByFirmCrdNumber": 125804,
                "allegedDamages": null,
                "eventDate": "2013-08-14",
                "satisfies4530Filing": null
            },
            {
                "disclosureTypeCode": "Civil Judicial Action",
                "formTypeCode": "U5",
                "statusDate": "2020-02-21",
                "filingNumber": 3377073673,
                "comments": null,
                "filedByFirmName": "MOODY FINANCIAL GROUP, INC.",
                "filedByRegulatorName": null,
                "filingDate": "2019-01-14",
                "occurrenceNumber": 5338275277,
                "pending": "YES",
                "firstReportedDate": "2019-01-14",
                "disclosureTypeName": "civil judicial action",
                "filedByRegulatorCode": null,
                "disclosureStatus": "PENDING",
                "amendableFlag": "YES",
                "filedByRegulatorNumber": null,
                "employingFirmName": "MOODY FINANCIAL GROUP, INC.",
                "filingTypeCode": "AMENDMENT",
                "allegations": "SEC RULE 15CE-1 WAS VIOLATED BY HAVING A NET CAPITAL DEFICIENCY ON 1-29-88 AND 2-29-88",
                "filedByFirmCrdNumber": 37646,
                "allegedDamages": null,
                "eventDate": "2018-12-14",
                "satisfies4530Filing": null
            },
            {
                "disclosureTypeCode": "Civil Judicial Action",
                "formTypeCode": "U5",
                "statusDate": "2021-02-01",
                "filingNumber": 9353299348,
                "comments": null,
                "filedByFirmName": "US EURO SECURITIES, INC",
                "filedByRegulatorName": null,
                "filingDate": "2020-09-24",
                "occurrenceNumber": 5338275277,
                "pending": "NO",
                "firstReportedDate": "2020-09-24",
                "disclosureTypeName": "civil judicial action",
                "filedByRegulatorCode": null,
                "disclosureStatus": "FINAL",
                "amendableFlag": "NO",
                "filedByRegulatorNumber": null,
                "employingFirmName": "US EURO SECURITIES, INC",
                "filingTypeCode": "AMENDMENT",
                "allegations": "FOUND TO HAVE VIOLATED PRINCIPLES OF N.Y.S.E. RULE 406(1), 408(a) & 440.",
                "filedByFirmCrdNumber": 38839,
                "allegedDamages": null,
                "eventDate": "2020-09-14",
                "satisfies4530Filing": null
            },
            {
                "disclosureTypeCode": "Civil Judicial Action",
                "formTypeCode": "U4",
                "statusDate": "2018-02-10",
                "filingNumber": 6791632487,
                "comments": null,
                "filedByFirmName": "BROCKINGTON SECURITIES, INC.",
                "filedByRegulatorName": null,
                "filingDate": "2015-05-29",
                "occurrenceNumber": 5338275277,
                "pending": "NO",
                "firstReportedDate": "2015-05-29",
                "disclosureTypeName": "civil judicial action",
                "filedByRegulatorCode": null,
                "disclosureStatus": "FINAL",
                "amendableFlag": "NO",
                "filedByRegulatorNumber": null,
                "employingFirmName": "BROCKINGTON SECURITIES, INC.",
                "filingTypeCode": "AMENDMENT",
                "allegations": "FAILURE TO COMPLY WITH FREE RIDING AND WITHHOLDING ARTICLE III SEC. I RULES OF FAIR PRACTICE IN CONNECTION WITH THE SALE OF 800 UNITS OF TOPOLOGIX. FINE 1500.00",
                "filedByFirmCrdNumber": 37438,
                "allegedDamages": null,
                "eventDate": "2015-03-14",
                "satisfies4530Filing": null
            },
            {
                "disclosureTypeCode": "Civil Judicial Action",
                "formTypeCode": "U6",
                "statusDate": "2021-03-06",
                "filingNumber": 1492885680,
                "comments": null,
                "filedByFirmName": "CAN-AM SECURITIES, INC.",
                "filedByRegulatorName": null,
                "filingDate": "2020-11-22",
                "occurrenceNumber": 5338275277,
                "pending": "NO",
                "firstReportedDate": "2020-11-22",
                "disclosureTypeName": "civil judicial action",
                "filedByRegulatorCode": null,
                "disclosureStatus": "FINAL",
                "amendableFlag": "NO",
                "filedByRegulatorNumber": null,
                "employingFirmName": "CAN-AM SECURITIES, INC.",
                "filingTypeCode": "AMENDMENT",
                "allegations": "THE CBOE HAS CHARGED THAT DURING THE PERIOD FROM JUNE, 1988 THROUGH NOVEMBER, 1988 THAT PRUDENTIAL SECURITIES INCORPORATED AND MR. BALLAN FAILED TO ADEQUATELY SUPERVISE MR. JOHN S. CZIPRUSZ, WHO WAS A PRUDENTIAL REGISTERED REPRESENTATIVE, BY ALLOWING MR. CZIPRUSZ TO EFFECT OPTIONS TRANSACTIONS IN A CUSTOMER'S ACCOUNTS WHICH TRANSACTIONS WERE UNSUITABLE AND EXCESSIVE IN SIZE IN VIOLATION OF EXCHANGE RULE 4.2. (ADHERENCE TO LAW) AND 9.8 (SUPERVISION OF ACCOUNTS).",
                "filedByFirmCrdNumber": 5160,
                "allegedDamages": null,
                "eventDate": "2020-11-14",
                "satisfies4530Filing": null
            },
            {
                "disclosureTypeCode": "Civil Judicial Action",
                "formTypeCode": "U6",
                "statusDate": "2019-07-23",
                "filingNumber": 7588634259,
                "comments": null,
                "filedByFirmName": "GEORGE WEISS & COMPANY LLC",
                "filedByRegulatorName": null,
                "filingDate": "2017-12-28",
                "occurrenceNumber": 5338275277,
                "pending": "NO",
                "firstReportedDate": "2017-12-28",
                "disclosureTypeName": "civil judicial action",
                "filedByRegulatorCode": null,
                "disclosureStatus": "FINAL",
                "amendableFlag": "NO",
                "filedByRegulatorNumber": null,
                "employingFirmName": "GEORGE WEISS & COMPANY LLC",
                "filingTypeCode": "AMENDMENT",
                "allegations": "ALLEGATIONS WERE AGAINST CAROLINA SECURITIES CORP. - NO INDIVIDUAL  PERSON WAS NAMED.",
                "filedByFirmCrdNumber": 41526,
                "allegedDamages": null,
                "eventDate": "2017-11-14",
                "satisfies4530Filing": null
            }
        ]
    }
]

 

Employments

List of employment records for registered individuals including detailed firm information and termination reason.

Dataset Info:

group dataset test dataset
firm registeredIndividualEmployments registeredIndividualEmploymentsMock

 

Sample Request
https://api.finra.org/data/group/firm/name/registeredIndividualEmploymentsMock?limit=5

 

Sample Response
[
    {
        "registrations": [
            {
                "regulatorCode": "NQX"
            },
            {
                "regulatorCode": "NYSE-AMER"
            }
        ],
        "employments": [
            {
                "independentContractorFlag": "YES",
                "firmCrdNumber": 3000005,
                "isActive": "YES",
                "employmentStartDate": "2002-10-15",
                "terminationReasonCode": null,
                "fingerprintCardBarCode": "9.637401211E9",
                "fingerprintCardStatusDate": "1971-06-02",
                "individualBillingCode": "U6FOPY5YZX",
                "employmentEndDate": null,
                "isFingerprintStatusFinal": "YES",
                "fingerprintCardDueDate": "1979-05-19",
                "terminationReasonDescription": null,
                "employmentTypeCode": "REGISTERED REPRESENTATIVE/PRINCIPAL"
            }
        ],
        "individualCrdNumber": 1
    },
    {
        "registrations": [
            {
                "regulatorCode": "NYSE-AMER"
            },
            {
                "regulatorCode": "NQX"
            }
        ],
        "employments": [
            {
                "independentContractorFlag": "NO",
                "firmCrdNumber": 3000005,
                "isActive": "YES",
                "employmentStartDate": "2014-08-25",
                "terminationReasonCode": null,
                "fingerprintCardBarCode": "8.046319478E9",
                "fingerprintCardStatusDate": "1987-01-13",
                "individualBillingCode": "POUOIRX7VN",
                "employmentEndDate": null,
                "isFingerprintStatusFinal": "YES",
                "fingerprintCardDueDate": "1980-10-25",
                "terminationReasonDescription": null,
                "employmentTypeCode": "REGISTERED REPRESENTATIVE/PRINCIPAL AND INVESTMENT ADVISER REPRESENTATIVE"
            }
        ],
        "individualCrdNumber": 10
    },
    {
        "registrations": [
            {
                "regulatorCode": "CBOE C2"
            },
            {
                "regulatorCode": "MEMX"
            }
        ],
        "employments": [
            {
                "independentContractorFlag": "NO",
                "firmCrdNumber": 3000005,
                "isActive": "YES",
                "employmentStartDate": "1989-01-11",
                "terminationReasonCode": null,
                "fingerprintCardBarCode": "8.682626078E9",
                "fingerprintCardStatusDate": "1995-10-31",
                "individualBillingCode": "8YSTQHNMEQ",
                "employmentEndDate": null,
                "isFingerprintStatusFinal": "YES",
                "fingerprintCardDueDate": "1982-07-19",
                "terminationReasonDescription": null,
                "employmentTypeCode": "REGISTERED REPRESENTATIVE/PRINCIPAL"
            }
        ],
        "individualCrdNumber": 100
    },
    {
        "registrations": [
            {
                "regulatorCode": "MIAX OPTIONS"
            },
            {
                "regulatorCode": "NYSE-AMER"
            }
        ],
        "employments": [
            {
                "independentContractorFlag": "YES",
                "firmCrdNumber": 3000005,
                "isActive": "YES",
                "employmentStartDate": "1999-05-12",
                "terminationReasonCode": null,
                "fingerprintCardBarCode": "7.614008373E9",
                "fingerprintCardStatusDate": "2000-09-14",
                "individualBillingCode": "XCGMIFMO4G",
                "employmentEndDate": null,
                "isFingerprintStatusFinal": "YES",
                "fingerprintCardDueDate": "1973-08-03",
                "terminationReasonDescription": null,
                "employmentTypeCode": "REGISTERED REPRESENTATIVE/PRINCIPAL"
            }
        ],
        "individualCrdNumber": 1000
    },
    {
        "registrations": [
            {
                "regulatorCode": "NYSE-CHI"
            },
            {
                "regulatorCode": "HI"
            }
        ],
        "employments": [
            {
                "independentContractorFlag": "YES",
                "firmCrdNumber": 3000005,
                "isActive": "YES",
                "employmentStartDate": "1972-03-17",
                "terminationReasonCode": null,
                "fingerprintCardBarCode": "1.659846027E9",
                "fingerprintCardStatusDate": "1974-12-07",
                "individualBillingCode": "D9KLPHVIVF",
                "employmentEndDate": null,
                "isFingerprintStatusFinal": "YES",
                "fingerprintCardDueDate": "1983-10-08",
                "terminationReasonDescription": null,
                "employmentTypeCode": "REGISTERED REPRESENTATIVE/PRINCIPAL"
            },
            {
                "independentContractorFlag": "YES",
                "firmCrdNumber": 3000005,
                "isActive": "YES",
                "employmentStartDate": "2008-10-13",
                "terminationReasonCode": null,
                "fingerprintCardBarCode": "5.838802863E9",
                "fingerprintCardStatusDate": "2010-07-04",
                "individualBillingCode": "UWU6VGDCLM",
                "employmentEndDate": null,
                "isFingerprintStatusFinal": "YES",
                "fingerprintCardDueDate": "1994-02-26",
                "terminationReasonDescription": null,
                "employmentTypeCode": "REGISTERED REPRESENTATIVE/PRINCIPAL"
            }
        ],
        "individualCrdNumber": 10000
    }
]

 

Sample Request
https://api.finra.org/data/group/firm/name/registeredIndividualEmploymentsMock

 

Sample Request Payload
{
"limit":5,
"fields":["individualCrdNumber","employments.isActive","employments.firmCrdNumber","employments.fingerprintCardDueDate","employments.isFingerprintStatusFinal"],  
"compareFilters": [ 
{"compareType": "greater", "fieldName": "individualCrdNumber", "fieldValue":10 }
]
}
 

 

Sample Response
[
    {
        "employments": [
            {
                "isFingerprintStatusFinal": "YES",
                "firmCrdNumber": 3000005,
                "fingerprintCardDueDate": "1982-07-19",
                "isActive": "YES"
            }
        ],
        "individualCrdNumber": 100
    },
    {
        "employments": [
            {
                "isFingerprintStatusFinal": "YES",
                "firmCrdNumber": 3000005,
                "fingerprintCardDueDate": "1973-08-03",
                "isActive": "YES"
            }
        ],
        "individualCrdNumber": 1000
    },
    {
        "employments": [
            {
                "isFingerprintStatusFinal": "YES",
                "firmCrdNumber": 3000005,
                "fingerprintCardDueDate": "1983-10-08",
                "isActive": "YES"
            },
            {
                "isFingerprintStatusFinal": "YES",
                "firmCrdNumber": 3000005,
                "fingerprintCardDueDate": "1994-02-26",
                "isActive": "YES"
            }
        ],
        "individualCrdNumber": 10000
    },
    {
        "employments": [
            {
                "isFingerprintStatusFinal": "YES",
                "firmCrdNumber": 3000005,
                "fingerprintCardDueDate": "2001-03-03",
                "isActive": "YES"
            }
        ],
        "individualCrdNumber": 1001
    },
    {
        "employments": [
            {
                "isFingerprintStatusFinal": "YES",
                "firmCrdNumber": 3000005,
                "fingerprintCardDueDate": "1994-08-24",
                "isActive": "YES"
            }
        ],
        "individualCrdNumber": 1002
    }
]

 

FingerPrint

Fingerprint details of Individuals in a Firm.

Dataset Info:

group dataset test dataset
firm registeredIndividualFingerPrint registeredIndividualFingerPrintMock

 

Sample Request
https://api.finra.org/data/group/firm/name/registeredIndividualFingerPrintMock?limit=5

 

Sample Response
[
    {
        "registrations": [
            {
                "regulatorCode": "NQX"
            },
            {
                "regulatorCode": "NYSE-AMER"
            }
        ],
        "employments": [
            {
                "fingerprintCardBarCode": "9.637401211E9",
                "fingerprintCardStatusDate": "1971-06-02",
                "isFingerprintStatusFinal": "YES",
                "firmCrdNumber": 3000005,
                "fingerprintCardDueDate": "1979-05-19"
            }
        ],
        "individualCrdNumber": 1
    },
    {
        "registrations": [
            {
                "regulatorCode": "NYSE-AMER"
            },
            {
                "regulatorCode": "NQX"
            }
        ],
        "employments": [
            {
                "fingerprintCardBarCode": "8.046319478E9",
                "fingerprintCardStatusDate": "1987-01-13",
                "isFingerprintStatusFinal": "YES",
                "firmCrdNumber": 3000005,
                "fingerprintCardDueDate": "1980-10-25"
            }
        ],
        "individualCrdNumber": 10
    },
    {
        "registrations": [
            {
                "regulatorCode": "CBOE C2"
            },
            {
                "regulatorCode": "MEMX"
            }
        ],
        "employments": [
            {
                "fingerprintCardBarCode": "8.682626078E9",
                "fingerprintCardStatusDate": "1995-10-31",
                "isFingerprintStatusFinal": "YES",
                "firmCrdNumber": 3000005,
                "fingerprintCardDueDate": "1982-07-19"
            }
        ],
        "individualCrdNumber": 100
    },
    {
        "registrations": [
            {
                "regulatorCode": "MIAX OPTIONS"
            },
            {
                "regulatorCode": "NYSE-AMER"
            }
        ],
        "employments": [
            {
                "fingerprintCardBarCode": "7.614008373E9",
                "fingerprintCardStatusDate": "2000-09-14",
                "isFingerprintStatusFinal": "YES",
                "firmCrdNumber": 3000005,
                "fingerprintCardDueDate": "1973-08-03"
            }
        ],
        "individualCrdNumber": 1000
    },
    {
        "registrations": [
            {
                "regulatorCode": "NYSE-CHI"
            },
            {
                "regulatorCode": "HI"
            }
        ],
        "employments": [
            {
                "fingerprintCardBarCode": "1.659846027E9",
                "fingerprintCardStatusDate": "1974-12-07",
                "isFingerprintStatusFinal": "YES",
                "firmCrdNumber": 3000005,
                "fingerprintCardDueDate": "1983-10-08"
            },
            {
                "fingerprintCardBarCode": "5.838802863E9",
                "fingerprintCardStatusDate": "2010-07-04",
                "isFingerprintStatusFinal": "YES",
                "firmCrdNumber": 3000005,
                "fingerprintCardDueDate": "1994-02-26"
            }
        ],
        "individualCrdNumber": 10000
    }
]

 

Sample Request
https://api.finra.org/data/group/firm/name/registeredIndividualFingerPrintMock

 

Sample Request Payload
{
"limit":5,
"fields":["individualCrdNumber","registrations.regulatorCode","employments.fingerprintCardBarCode",
"employments.fingerprintCardStatusDate","employments.isFingerprintStatusFinal"],  
"compareFilters": [ 
{"compareType": "greater", "fieldName": "individualCrdNumber", "fieldValue":10 }
]
}
 

 

Sample Response
[
    {
        "registrations": [
            {
                "regulatorCode": "CBOE C2"
            },
            {
                "regulatorCode": "MEMX"
            }
        ],
        "employments": [
            {
                "fingerprintCardBarCode": "8.682626078E9",
                "fingerprintCardStatusDate": "1995-10-31",
                "isFingerprintStatusFinal": "YES"
            }
        ],
        "individualCrdNumber": 100
    },
    {
        "registrations": [
            {
                "regulatorCode": "MIAX OPTIONS"
            },
            {
                "regulatorCode": "NYSE-AMER"
            }
        ],
        "employments": [
            {
                "fingerprintCardBarCode": "7.614008373E9",
                "fingerprintCardStatusDate": "2000-09-14",
                "isFingerprintStatusFinal": "YES"
            }
        ],
        "individualCrdNumber": 1000
    },
    {
        "registrations": [
            {
                "regulatorCode": "NYSE-CHI"
            },
            {
                "regulatorCode": "HI"
            }
        ],
        "employments": [
            {
                "fingerprintCardBarCode": "1.659846027E9",
                "fingerprintCardStatusDate": "1974-12-07",
                "isFingerprintStatusFinal": "YES"
            },
            {
                "fingerprintCardBarCode": "5.838802863E9",
                "fingerprintCardStatusDate": "2010-07-04",
                "isFingerprintStatusFinal": "YES"
            }
        ],
        "individualCrdNumber": 10000
    },
    {
        "registrations": [
            {
                "regulatorCode": "BX"
            },
            {
                "regulatorCode": "CBOE"
            }
        ],
        "employments": [
            {
                "fingerprintCardBarCode": "5.786548603E9",
                "fingerprintCardStatusDate": "1972-10-07",
                "isFingerprintStatusFinal": "YES"
            }
        ],
        "individualCrdNumber": 1001
    },
    {
        "registrations": [
            {
                "regulatorCode": "CBOE EDGX"
            },
            {
                "regulatorCode": "NYSE"
            }
        ],
        "employments": [
            {
                "fingerprintCardBarCode": "2.508134714E9",
                "fingerprintCardStatusDate": "2009-03-05",
                "isFingerprintStatusFinal": "YES"
            }
        ],
        "individualCrdNumber": 1002
    }
]

 

Firm Disclosures

Firm disclosure information.

Dataset Info:

group dataset test dataset
firm firmDisclosures firmDisclosuresMock

 

Sample Request
https://api.finra.org/data/group/firm/name/firmDisclosuresMock?limit=5

 

Sample Response
[
    {
        "registrations": [
            {
                "regulatorCode": "WV"
            },
            {
                "regulatorCode": "NQX"
            },
            {
                "regulatorCode": "LTSE"
            },
            {
                "regulatorCode": "SD"
            },
            {
                "regulatorCode": "VSE"
            },
            {
                "regulatorCode": "SRR"
            },
            {
                "regulatorCode": "TOSE"
            },
            {
                "regulatorCode": "LSX"
            },
            {
                "regulatorCode": "NQX"
            },
            {
                "regulatorCode": "CFTC"
            },
            {
                "regulatorCode": "PFS"
            },
            {
                "regulatorCode": "NYSE"
            },
            {
                "regulatorCode": "FTC"
            },
            {
                "regulatorCode": "WA"
            },
            {
                "regulatorCode": "TN"
            },
            {
                "regulatorCode": "CA"
            },
            {
                "regulatorCode": "CCFE"
            },
            {
                "regulatorCode": "ID"
            },
            {
                "regulatorCode": "CBOT"
            },
            {
                "regulatorCode": "CBOE"
            },
            {
                "regulatorCode": "CO"
            },
            {
                "regulatorCode": "CC"
            },
            {
                "regulatorCode": "BX"
            },
            {
                "regulatorCode": "NFX"
            },
            {
                "regulatorCode": "ISE MRX"
            },
            {
                "regulatorCode": "NADF"
            },
            {
                "regulatorCode": "USPS"
            }
        ],
        "firmCrdNumber": 3000005,
        "disclosures": [
            {
                "disclosureType": "CRIMINAL",
                "reportableFlag": "NO",
                "occurrenceNumber": 1064547,
                "eventDate": "1976-06-11",
                "disclosableFlag": "NO",
                "archivedFlag": "NO"
            },
            {
                "disclosureType": "ARBTN",
                "reportableFlag": "NO",
                "occurrenceNumber": 2559338,
                "eventDate": "1973-09-19",
                "disclosableFlag": "NO",
                "archivedFlag": "NO"
            },
            {
                "disclosureType": "ARBTN",
                "reportableFlag": "NO",
                "occurrenceNumber": 1228140,
                "eventDate": "1977-11-17",
                "disclosableFlag": "NO",
                "archivedFlag": "NO"
            },
            {
                "disclosureType": "CUSTCOMP",
                "reportableFlag": "NO",
                "occurrenceNumber": 4726649,
                "eventDate": "2007-07-31",
                "disclosableFlag": "NO",
                "archivedFlag": "NO"
            },
            {
                "disclosureType": "ARBTN",
                "reportableFlag": "NO",
                "occurrenceNumber": 5185014,
                "eventDate": "1974-12-22",
                "disclosableFlag": "NO",
                "archivedFlag": "NO"
            },
            {
                "disclosureType": "BOND",
                "reportableFlag": "NO",
                "occurrenceNumber": 6750812,
                "eventDate": "1989-11-02",
                "disclosableFlag": "NO",
                "archivedFlag": "NO"
            },
            {
                "disclosureType": "BANKRUPT",
                "reportableFlag": "NO",
                "occurrenceNumber": 2694209,
                "eventDate": "1977-10-31",
                "disclosableFlag": "NO",
                "archivedFlag": "NO"
            },
            {
                "disclosureType": "CRIMINAL",
                "reportableFlag": "NO",
                "occurrenceNumber": 1327993,
                "eventDate": "1978-05-20",
                "disclosableFlag": "NO",
                "archivedFlag": "NO"
            },
            {
                "disclosureType": "INTRNRVW",
                "reportableFlag": "NO",
                "occurrenceNumber": 3082430,
                "eventDate": "1993-11-29",
                "disclosableFlag": "NO",
                "archivedFlag": "NO"
            },
            {
                "disclosureType": "BANKRUPT",
                "reportableFlag": "NO",
                "occurrenceNumber": 9242702,
                "eventDate": "1970-07-04",
                "disclosableFlag": "NO",
                "archivedFlag": "NO"
            },
            {
                "disclosureType": "CUSTCOMP",
                "reportableFlag": "NO",
                "occurrenceNumber": 7073869,
                "eventDate": "2004-11-28",
                "disclosableFlag": "NO",
                "archivedFlag": "NO"
            },
            {
                "disclosureType": "CUSTCOMP",
                "reportableFlag": "NO",
                "occurrenceNumber": 21597,
                "eventDate": "1991-09-22",
                "disclosableFlag": "NO",
                "archivedFlag": "NO"
            },
            {
                "disclosureType": "INVSTGTN",
                "reportableFlag": "NO",
                "occurrenceNumber": 1516197,
                "eventDate": "1972-09-25",
                "disclosableFlag": "NO",
                "archivedFlag": "NO"
            },
            {
                "disclosureType": "CUSTCOMP",
                "reportableFlag": "NO",
                "occurrenceNumber": 1818524,
                "eventDate": "2003-01-08",
                "disclosableFlag": "NO",
                "archivedFlag": "NO"
            },
            {
                "disclosureType": "JUDGEMNT",
                "reportableFlag": "NO",
                "occurrenceNumber": 3616978,
                "eventDate": "1991-02-19",
                "disclosableFlag": "NO",
                "archivedFlag": "NO"
            },
            {
                "disclosureType": "ARBTN",
                "reportableFlag": "NO",
                "occurrenceNumber": 2529525,
                "eventDate": "1977-03-11",
                "disclosableFlag": "NO",
                "archivedFlag": "NO"
            },
            {
                "disclosureType": "ARBTN",
                "reportableFlag": "NO",
                "occurrenceNumber": 9003604,
                "eventDate": "2005-09-03",
                "disclosableFlag": "NO",
                "archivedFlag": "NO"
            }
        ]
    }
]

 

Sample Request
https://api.finra.org/data/group/firm/name/firmDisclosuresMock

 

Sample Request Payload
{
"limit":5,
"fields":["registrations.regulatorCode","firmCrdNumber","disclosures.disclosureType"] 
}
 

 

Sample Response
[
    {
        "registrations": [
            {
                "regulatorCode": "WV"
            },
            {
                "regulatorCode": "NQX"
            },
            {
                "regulatorCode": "LTSE"
            },
            {
                "regulatorCode": "SD"
            },
            {
                "regulatorCode": "VSE"
            },
            {
                "regulatorCode": "SRR"
            },
            {
                "regulatorCode": "TOSE"
            },
            {
                "regulatorCode": "LSX"
            },
            {
                "regulatorCode": "NQX"
            },
            {
                "regulatorCode": "CFTC"
            },
            {
                "regulatorCode": "PFS"
            },
            {
                "regulatorCode": "NYSE"
            },
            {
                "regulatorCode": "FTC"
            },
            {
                "regulatorCode": "WA"
            },
            {
                "regulatorCode": "TN"
            },
            {
                "regulatorCode": "CA"
            },
            {
                "regulatorCode": "CCFE"
            },
            {
                "regulatorCode": "ID"
            },
            {
                "regulatorCode": "CBOT"
            },
            {
                "regulatorCode": "CBOE"
            },
            {
                "regulatorCode": "CO"
            },
            {
                "regulatorCode": "CC"
            },
            {
                "regulatorCode": "BX"
            },
            {
                "regulatorCode": "NFX"
            },
            {
                "regulatorCode": "ISE MRX"
            },
            {
                "regulatorCode": "NADF"
            },
            {
                "regulatorCode": "USPS"
            }
        ],
        "firmCrdNumber": 3000005,
        "disclosures": [
            {
                "disclosureType": "CRIMINAL"
            },
            {
                "disclosureType": "ARBTN"
            },
            {
                "disclosureType": "ARBTN"
            },
            {
                "disclosureType": "CUSTCOMP"
            },
            {
                "disclosureType": "ARBTN"
            },
            {
                "disclosureType": "BOND"
            },
            {
                "disclosureType": "BANKRUPT"
            },
            {
                "disclosureType": "CRIMINAL"
            },
            {
                "disclosureType": "INTRNRVW"
            },
            {
                "disclosureType": "BANKRUPT"
            },
            {
                "disclosureType": "CUSTCOMP"
            },
            {
                "disclosureType": "CUSTCOMP"
            },
            {
                "disclosureType": "INVSTGTN"
            },
            {
                "disclosureType": "CUSTCOMP"
            },
            {
                "disclosureType": "JUDGEMNT"
            },
            {
                "disclosureType": "ARBTN"
            },
            {
                "disclosureType": "ARBTN"
            }
        ]
    }
]

 

Firm Profile

Basic information about a firm.

Dataset Info:

group dataset test dataset
firm firmProfile firmProfileMock

 

Sample Request
https://api.finra.org/data/group/firm/name/firmProfileMock?limit=5

 

Sample Response
[
    {
        "sec8FirmIdentifier": "65620",
        "firmApplicantName": "ATLAS ONE FINANCIAL GROUP, LLC",
        "registrations": [
            {
                "regulatorCode": "WV"
            },
            {
                "regulatorCode": "NQX"
            },
            {
                "regulatorCode": "LTSE"
            },
            {
                "regulatorCode": "SD"
            },
            {
                "regulatorCode": "VSE"
            },
            {
                "regulatorCode": "SRR"
            },
            {
                "regulatorCode": "TOSE"
            },
            {
                "regulatorCode": "LSX"
            },
            {
                "regulatorCode": "NQX"
            },
            {
                "regulatorCode": "CFTC"
            },
            {
                "regulatorCode": "PFS"
            },
            {
                "regulatorCode": "NYSE"
            },
            {
                "regulatorCode": "FTC"
            },
            {
                "regulatorCode": "WA"
            },
            {
                "regulatorCode": "TN"
            },
            {
                "regulatorCode": "CA"
            },
            {
                "regulatorCode": "CCFE"
            },
            {
                "regulatorCode": "ID"
            },
            {
                "regulatorCode": "CBOT"
            },
            {
                "regulatorCode": "CBOE"
            },
            {
                "regulatorCode": "CO"
            },
            {
                "regulatorCode": "CC"
            },
            {
                "regulatorCode": "BX"
            },
            {
                "regulatorCode": "NFX"
            },
            {
                "regulatorCode": "ISE MRX"
            },
            {
                "regulatorCode": "NADF"
            },
            {
                "regulatorCode": "USPS"
            }
        ],
        "doingBusinessAsName": "ATLAS ONE FINANCIAL GROUP, LLC",
        "registeredFirmTypeCode": "JOINT",
        "firmFinraDistrict": "9-Woodbridge",
        "firmCrdNumber": 3000005,
        "sec802FirmIdentifier": null,
        "firmAddress": {
            "cityName": "Layton",
            "stateName": "Idaho",
            "countryCode": "USA",
            "postalCode": "89084",
            "addressLine1": "1299 Gracemar",
            "addressLine2": null,
            "stateCode": "ID",
            "countryName": "United States of America"
        },
        "sec801FirmIdentifier": null
    }
]

 

Sample Request
https://api.finra.org/data/group/firm/name/firmProfileMock

 

Sample Request Payload
{
"limit":5,
"fields":["registrations.regulatorCode","sec8FirmIdentifier","firmApplicantName",
"registeredFirmTypeCode","firmFinraDistrict"] 
}
 

 

Sample Response
[
    {
        "sec8FirmIdentifier": "65620",
        "firmApplicantName": "ATLAS ONE FINANCIAL GROUP, LLC",
        "registrations": [
            {
                "regulatorCode": "WV"
            },
            {
                "regulatorCode": "NQX"
            },
            {
                "regulatorCode": "LTSE"
            },
            {
                "regulatorCode": "SD"
            },
            {
                "regulatorCode": "VSE"
            },
            {
                "regulatorCode": "SRR"
            },
            {
                "regulatorCode": "TOSE"
            },
            {
                "regulatorCode": "LSX"
            },
            {
                "regulatorCode": "NQX"
            },
            {
                "regulatorCode": "CFTC"
            },
            {
                "regulatorCode": "PFS"
            },
            {
                "regulatorCode": "NYSE"
            },
            {
                "regulatorCode": "FTC"
            },
            {
                "regulatorCode": "WA"
            },
            {
                "regulatorCode": "TN"
            },
            {
                "regulatorCode": "CA"
            },
            {
                "regulatorCode": "CCFE"
            },
            {
                "regulatorCode": "ID"
            },
            {
                "regulatorCode": "CBOT"
            },
            {
                "regulatorCode": "CBOE"
            },
            {
                "regulatorCode": "CO"
            },
            {
                "regulatorCode": "CC"
            },
            {
                "regulatorCode": "BX"
            },
            {
                "regulatorCode": "NFX"
            },
            {
                "regulatorCode": "ISE MRX"
            },
            {
                "regulatorCode": "NADF"
            },
            {
                "regulatorCode": "USPS"
            }
        ],
        "registeredFirmTypeCode": "JOINT",
        "firmFinraDistrict": "9-Woodbridge"
    }
]

 

Firm Registration Status History

A complete listing of registration notices for a firm.

Dataset Info:

group dataset test dataset
firm firmRegistrationStatusHistory firmRegistrationStatusHistoryMock

 

Sample Request
https://api.finra.org/data/group/firm/name/firmRegistrationStatusHistoryMock?limit=5

 

Sample Response
[
    {
        "registrationStatusHistory": [
            {
                "regulatorName": "Oklahoma",
                "noticeDate": "1970-03-25",
                "noticeReason": "Withdrawn",
                "statusName": "Withdrawn",
                "regulatorCode": "OK",
                "statusCode": "WITHDRAWN"
            },
            {
                "regulatorName": "New York",
                "noticeDate": "1970-01-28",
                "noticeReason": "Terminated",
                "statusName": "Terminated",
                "regulatorCode": "NY",
                "statusCode": "TERMINATED"
            },
            {
                "regulatorName": "ELX Futures LP",
                "noticeDate": "1995-11-15",
                "noticeReason": "Withdrawn",
                "statusName": "Withdrawn",
                "regulatorCode": "ELX",
                "statusCode": "WITHDRAWN"
            },
            {
                "regulatorName": "Yukon Territory",
                "noticeDate": "1973-04-26",
                "noticeReason": "Withdrawn",
                "statusName": "Withdrawn",
                "regulatorCode": "YT",
                "statusCode": "WITHDRAWN"
            },
            {
                "regulatorName": "Comptroller of the Currency",
                "noticeDate": "1991-02-16",
                "noticeReason": "Terminated",
                "statusName": "Terminated",
                "regulatorCode": "CC",
                "statusCode": "TERMINATED"
            },
            {
                "regulatorName": "Chicago Board of Trade",
                "noticeDate": "2012-09-12",
                "noticeReason": "Withdrawn",
                "statusName": "Withdrawn",
                "regulatorCode": "CBOT",
                "statusCode": "WITHDRAWN"
            },
            {
                "regulatorName": "Complinet Ltd",
                "noticeDate": "2014-10-18",
                "noticeReason": "Terminated",
                "statusName": "Terminated",
                "regulatorCode": "CMPLNT",
                "statusCode": "TERMINATED"
            },
            {
                "regulatorName": "Guam",
                "noticeDate": "1986-08-09",
                "noticeReason": "Terminated",
                "statusName": "Terminated",
                "regulatorCode": "GU",
                "statusCode": "TERMINATED"
            },
            {
                "regulatorName": "Securities Investment Protection Corporation",
                "noticeDate": "1971-06-28",
                "noticeReason": "Withdrawn",
                "statusName": "Withdrawn",
                "regulatorCode": "SIPC",
                "statusCode": "WITHDRAWN"
            },
            {
                "regulatorName": "NYSE Chicago, Inc.",
                "noticeDate": "1976-12-28",
                "noticeReason": "Withdrawn",
                "statusName": "Withdrawn",
                "regulatorCode": "NYSE-CHI",
                "statusCode": "WITHDRAWN"
            },
            {
                "regulatorName": "Virgin Islands",
                "noticeDate": "1980-02-24",
                "noticeReason": "Terminated",
                "statusName": "Terminated",
                "regulatorCode": "VI",
                "statusCode": "TERMINATED"
            },
            {
                "regulatorName": "ELX Futures LP",
                "noticeDate": "1986-12-22",
                "noticeReason": "Withdrawn",
                "statusName": "Withdrawn",
                "regulatorCode": "ELX",
                "statusCode": "WITHDRAWN"
            },
            {
                "regulatorName": "U.S. Postal Inspection Service",
                "noticeDate": "1981-01-04",
                "noticeReason": "Withdrawn",
                "statusName": "Withdrawn",
                "regulatorCode": "USPS",
                "statusCode": "WITHDRAWN"
            },
            {
                "regulatorName": "MEMX LLC",
                "noticeDate": "2003-04-11",
                "noticeReason": "Terminated",
                "statusName": "Terminated",
                "regulatorCode": "MEMX",
                "statusCode": "TERMINATED"
            },
            {
                "regulatorName": "Maryland",
                "noticeDate": "1979-07-13",
                "noticeReason": "Withdrawn",
                "statusName": "Withdrawn",
                "regulatorCode": "MD",
                "statusCode": "WITHDRAWN"
            },
            {
                "regulatorName": "Massachusetts",
                "noticeDate": "1997-01-02",
                "noticeReason": "Terminated",
                "statusName": "Terminated",
                "regulatorCode": "MA",
                "statusCode": "TERMINATED"
            },
            {
                "regulatorName": "Commodity Exchange Inc",
                "noticeDate": "1999-06-10",
                "noticeReason": "Terminated",
                "statusName": "Terminated",
                "regulatorCode": "COMEX",
                "statusCode": "TERMINATED"
            },
            {
                "regulatorName": "Connecticut",
                "noticeDate": "1995-09-19",
                "noticeReason": "Withdrawn",
                "statusName": "Withdrawn",
                "regulatorCode": "CT",
                "statusCode": "WITHDRAWN"
            },
            {
                "regulatorName": "Alabama",
                "noticeDate": "1982-10-04",
                "noticeReason": "Withdrawn",
                "statusName": "Withdrawn",
                "regulatorCode": "AL",
                "statusCode": "WITHDRAWN"
            },
            {
                "regulatorName": "Montana",
                "noticeDate": "1988-11-05",
                "noticeReason": "Withdrawn",
                "statusName": "Withdrawn",
                "regulatorCode": "MT",
                "statusCode": "WITHDRAWN"
            },
            {
                "regulatorName": "Securities Information Center",
                "noticeDate": "1975-08-08",
                "noticeReason": "Withdrawn",
                "statusName": "Withdrawn",
                "regulatorCode": "SIC",
                "statusCode": "WITHDRAWN"
            },
            {
                "regulatorName": "North Dakota",
                "noticeDate": "1996-09-01",
                "noticeReason": "Terminated",
                "statusName": "Terminated",
                "regulatorCode": "ND",
                "statusCode": "TERMINATED"
            },
            {
                "regulatorName": "New Hampshire",
                "noticeDate": "1988-06-23",
                "noticeReason": "Terminated",
                "statusName": "Terminated",
                "regulatorCode": "NH",
                "statusCode": "TERMINATED"
            }
        ],
        "firmCrdNumber": 3000005
    }
]

 

Sample Request
https://api.finra.org/data/group/firm/name/firmRegistrationStatusHistoryMock

 

Sample Request Payload
{
	"fields":["registrationStatusHistory.regulatorName","registrationStatusHistory.noticeDate",
	"registrationStatusHistory.noticeReason","registrationStatusHistory.regulatorCode"]
}
 

 

Sample Response
[
    {
        "registrationStatusHistory": [
            {
                "regulatorName": "Oklahoma",
                "noticeDate": "1970-03-25",
                "noticeReason": "Withdrawn",
                "regulatorCode": "OK"
            },
            {
                "regulatorName": "New York",
                "noticeDate": "1970-01-28",
                "noticeReason": "Terminated",
                "regulatorCode": "NY"
            },
            {
                "regulatorName": "ELX Futures LP",
                "noticeDate": "1995-11-15",
                "noticeReason": "Withdrawn",
                "regulatorCode": "ELX"
            },
            {
                "regulatorName": "Yukon Territory",
                "noticeDate": "1973-04-26",
                "noticeReason": "Withdrawn",
                "regulatorCode": "YT"
            },
            {
                "regulatorName": "Comptroller of the Currency",
                "noticeDate": "1991-02-16",
                "noticeReason": "Terminated",
                "regulatorCode": "CC"
            },
            {
                "regulatorName": "Chicago Board of Trade",
                "noticeDate": "2012-09-12",
                "noticeReason": "Withdrawn",
                "regulatorCode": "CBOT"
            },
            {
                "regulatorName": "Complinet Ltd",
                "noticeDate": "2014-10-18",
                "noticeReason": "Terminated",
                "regulatorCode": "CMPLNT"
            },
            {
                "regulatorName": "Guam",
                "noticeDate": "1986-08-09",
                "noticeReason": "Terminated",
                "regulatorCode": "GU"
            },
            {
                "regulatorName": "Securities Investment Protection Corporation",
                "noticeDate": "1971-06-28",
                "noticeReason": "Withdrawn",
                "regulatorCode": "SIPC"
            },
            {
                "regulatorName": "NYSE Chicago, Inc.",
                "noticeDate": "1976-12-28",
                "noticeReason": "Withdrawn",
                "regulatorCode": "NYSE-CHI"
            },
            {
                "regulatorName": "Virgin Islands",
                "noticeDate": "1980-02-24",
                "noticeReason": "Terminated",
                "regulatorCode": "VI"
            },
            {
                "regulatorName": "ELX Futures LP",
                "noticeDate": "1986-12-22",
                "noticeReason": "Withdrawn",
                "regulatorCode": "ELX"
            },
            {
                "regulatorName": "U.S. Postal Inspection Service",
                "noticeDate": "1981-01-04",
                "noticeReason": "Withdrawn",
                "regulatorCode": "USPS"
            },
            {
                "regulatorName": "MEMX LLC",
                "noticeDate": "2003-04-11",
                "noticeReason": "Terminated",
                "regulatorCode": "MEMX"
            },
            {
                "regulatorName": "Maryland",
                "noticeDate": "1979-07-13",
                "noticeReason": "Withdrawn",
                "regulatorCode": "MD"
            },
            {
                "regulatorName": "Massachusetts",
                "noticeDate": "1997-01-02",
                "noticeReason": "Terminated",
                "regulatorCode": "MA"
            },
            {
                "regulatorName": "Commodity Exchange Inc",
                "noticeDate": "1999-06-10",
                "noticeReason": "Terminated",
                "regulatorCode": "COMEX"
            },
            {
                "regulatorName": "Connecticut",
                "noticeDate": "1995-09-19",
                "noticeReason": "Withdrawn",
                "regulatorCode": "CT"
            },
            {
                "regulatorName": "Alabama",
                "noticeDate": "1982-10-04",
                "noticeReason": "Withdrawn",
                "regulatorCode": "AL"
            },
            {
                "regulatorName": "Montana",
                "noticeDate": "1988-11-05",
                "noticeReason": "Withdrawn",
                "regulatorCode": "MT"
            },
            {
                "regulatorName": "Securities Information Center",
                "noticeDate": "1975-08-08",
                "noticeReason": "Withdrawn",
                "regulatorCode": "SIC"
            },
            {
                "regulatorName": "North Dakota",
                "noticeDate": "1996-09-01",
                "noticeReason": "Terminated",
                "regulatorCode": "ND"
            },
            {
                "regulatorName": "New Hampshire",
                "noticeDate": "1988-06-23",
                "noticeReason": "Terminated",
                "regulatorCode": "NH"
            }
        ]
    }
]

 

Firm Registrations

Firm registration information

Dataset Info:

group dataset test dataset
firm firmRegistrations firmRegistrationsMock

 

Sample Request
https://api.finra.org/data/group/firm/name/firmRegistrationsMock?limit=5

 

Sample Response
[
    {
        "registrations": [
            {
                "regulatorName": "West Virginia",
                "isCurrent": "YES",
                "registrationType": "BD",
                "statusName": "Terminated",
                "regulatorCode": "WV",
                "effectiveDate": "2009-08-18",
                "statusCode": "TERMINATED"
            },
            {
                "regulatorName": "Nasdaq Stock Market",
                "isCurrent": "YES",
                "registrationType": "BD",
                "statusName": "Withdrawn",
                "regulatorCode": "NQX",
                "effectiveDate": "1994-05-25",
                "statusCode": "WITHDRAWN"
            },
            {
                "regulatorName": "Long-Term Stock Exchange, Inc.",
                "isCurrent": "YES",
                "registrationType": "BD",
                "statusName": "Withdrawn",
                "regulatorCode": "LTSE",
                "effectiveDate": "2010-08-13",
                "statusCode": "WITHDRAWN"
            },
            {
                "regulatorName": "South Dakota",
                "isCurrent": "YES",
                "registrationType": "BD",
                "statusName": "Terminated",
                "regulatorCode": "SD",
                "effectiveDate": "1972-07-07",
                "statusCode": "TERMINATED"
            },
            {
                "regulatorName": "Canadian Venture Exchange",
                "isCurrent": "YES",
                "registrationType": "BD",
                "statusName": "Withdrawn",
                "regulatorCode": "VSE",
                "effectiveDate": "1984-06-19",
                "statusCode": "WITHDRAWN"
            },
            {
                "regulatorName": "State Regulatory Registry",
                "isCurrent": "YES",
                "registrationType": "BD",
                "statusName": "Withdrawn",
                "regulatorCode": "SRR",
                "effectiveDate": "2010-09-12",
                "statusCode": "WITHDRAWN"
            },
            {
                "regulatorName": "TOKYO STOCK EXCHANGE",
                "isCurrent": "YES",
                "registrationType": "BD",
                "statusName": "Revoked",
                "regulatorCode": "TOSE",
                "effectiveDate": "2011-03-21",
                "statusCode": "REVOKED"
            },
            {
                "regulatorName": "London Stock Exchange",
                "isCurrent": "YES",
                "registrationType": "BD",
                "statusName": "Withdrawn",
                "regulatorCode": "LSX",
                "effectiveDate": "2011-05-27",
                "statusCode": "WITHDRAWN"
            },
            {
                "regulatorName": "Nasdaq Stock Market",
                "isCurrent": "YES",
                "registrationType": "BD",
                "statusName": "Revoked",
                "regulatorCode": "NQX",
                "effectiveDate": "2010-06-09",
                "statusCode": "REVOKED"
            },
            {
                "regulatorName": "Commodity Futures Trading Commission",
                "isCurrent": "YES",
                "registrationType": "BD",
                "statusName": "Revoked",
                "regulatorCode": "CFTC",
                "effectiveDate": "1979-09-15",
                "statusCode": "REVOKED"
            },
            {
                "regulatorName": "American Institute of Certified Public Accountants",
                "isCurrent": "YES",
                "registrationType": "BD",
                "statusName": "Terminated",
                "regulatorCode": "PFS",
                "effectiveDate": "1987-09-09",
                "statusCode": "TERMINATED"
            },
            {
                "regulatorName": "New York Stock Exchange",
                "isCurrent": "YES",
                "registrationType": "BD",
                "statusName": "Revoked",
                "regulatorCode": "NYSE",
                "effectiveDate": "1984-04-17",
                "statusCode": "REVOKED"
            },
            {
                "regulatorName": "US Federal Trade Commission",
                "isCurrent": "YES",
                "registrationType": "BD",
                "statusName": "Approved",
                "regulatorCode": "FTC",
                "effectiveDate": "2000-09-20",
                "statusCode": "APPROVED"
            },
            {
                "regulatorName": "Washington",
                "isCurrent": "YES",
                "registrationType": "BD",
                "statusName": "Approved",
                "regulatorCode": "WA",
                "effectiveDate": "1987-06-25",
                "statusCode": "APPROVED"
            },
            {
                "regulatorName": "Tennessee",
                "isCurrent": "YES",
                "registrationType": "BD",
                "statusName": "Approved",
                "regulatorCode": "TN",
                "effectiveDate": "1998-02-14",
                "statusCode": "APPROVED"
            },
            {
                "regulatorName": "California",
                "isCurrent": "YES",
                "registrationType": "BD",
                "statusName": "Revoked",
                "regulatorCode": "CA",
                "effectiveDate": "2017-02-28",
                "statusCode": "REVOKED"
            },
            {
                "regulatorName": "Chicago Climate Futures Exchange",
                "isCurrent": "YES",
                "registrationType": "BD",
                "statusName": "Terminated",
                "regulatorCode": "CCFE",
                "effectiveDate": "1988-12-28",
                "statusCode": "TERMINATED"
            },
            {
                "regulatorName": "Idaho",
                "isCurrent": "YES",
                "registrationType": "BD",
                "statusName": "Withdrawn",
                "regulatorCode": "ID",
                "effectiveDate": "1984-08-11",
                "statusCode": "WITHDRAWN"
            },
            {
                "regulatorName": "Chicago Board of Trade",
                "isCurrent": "YES",
                "registrationType": "BD",
                "statusName": "Approved",
                "regulatorCode": "CBOT",
                "effectiveDate": "2011-11-05",
                "statusCode": "APPROVED"
            },
            {
                "regulatorName": "Cboe Exchange, Inc.",
                "isCurrent": "YES",
                "registrationType": "BD",
                "statusName": "Revoked",
                "regulatorCode": "CBOE",
                "effectiveDate": "1972-06-11",
                "statusCode": "REVOKED"
            },
            {
                "regulatorName": "Colorado",
                "isCurrent": "YES",
                "registrationType": "BD",
                "statusName": "Approved",
                "regulatorCode": "CO",
                "effectiveDate": "2001-06-27",
                "statusCode": "APPROVED"
            },
            {
                "regulatorName": "Comptroller of the Currency",
                "isCurrent": "YES",
                "registrationType": "BD",
                "statusName": "Withdrawn",
                "regulatorCode": "CC",
                "effectiveDate": "2015-10-20",
                "statusCode": "WITHDRAWN"
            },
            {
                "regulatorName": "Nasdaq BX, Inc.",
                "isCurrent": "YES",
                "registrationType": "BD",
                "statusName": "Approved",
                "regulatorCode": "BX",
                "effectiveDate": "2003-02-26",
                "statusCode": "APPROVED"
            },
            {
                "regulatorName": "NASDAQ Futures Exchange",
                "isCurrent": "YES",
                "registrationType": "BD",
                "statusName": "Revoked",
                "regulatorCode": "NFX",
                "effectiveDate": "1990-06-21",
                "statusCode": "REVOKED"
            },
            {
                "regulatorName": "Nasdaq MRX, LLC",
                "isCurrent": "YES",
                "registrationType": "BD",
                "statusName": "Approved",
                "regulatorCode": "ISE MRX",
                "effectiveDate": "1995-01-27",
                "statusCode": "APPROVED"
            },
            {
                "regulatorName": "FINRA ALTERNATIVE DISPLAY FACILITY",
                "isCurrent": "YES",
                "registrationType": "BD",
                "statusName": "Approved",
                "regulatorCode": "NADF",
                "effectiveDate": "1975-03-06",
                "statusCode": "APPROVED"
            },
            {
                "regulatorName": "U.S. Postal Inspection Service",
                "isCurrent": "YES",
                "registrationType": "BD",
                "statusName": "Approved",
                "regulatorCode": "USPS",
                "effectiveDate": "2011-06-09",
                "statusCode": "APPROVED"
            }
        ],
        "firmCrdNumber": 3000005
    }
]

 

Sample Request
https://api.finra.org/data/group/firm/name/firmRegistrationsMock

 

Sample Request Payload
{
	"fields":["registrations.regulatorName","registrations.isCurrent",
	"registrations.registrationType","registrations.regulatorCode"]
}
 

 

Sample Response
[
    {
        "registrations": [
            {
                "regulatorName": "West Virginia",
                "isCurrent": "YES",
                "registrationType": "BD",
                "regulatorCode": "WV"
            },
            {
                "regulatorName": "Nasdaq Stock Market",
                "isCurrent": "YES",
                "registrationType": "BD",
                "regulatorCode": "NQX"
            },
            {
                "regulatorName": "Long-Term Stock Exchange, Inc.",
                "isCurrent": "YES",
                "registrationType": "BD",
                "regulatorCode": "LTSE"
            },
            {
                "regulatorName": "South Dakota",
                "isCurrent": "YES",
                "registrationType": "BD",
                "regulatorCode": "SD"
            },
            {
                "regulatorName": "Canadian Venture Exchange",
                "isCurrent": "YES",
                "registrationType": "BD",
                "regulatorCode": "VSE"
            },
            {
                "regulatorName": "State Regulatory Registry",
                "isCurrent": "YES",
                "registrationType": "BD",
                "regulatorCode": "SRR"
            },
            {
                "regulatorName": "TOKYO STOCK EXCHANGE",
                "isCurrent": "YES",
                "registrationType": "BD",
                "regulatorCode": "TOSE"
            },
            {
                "regulatorName": "London Stock Exchange",
                "isCurrent": "YES",
                "registrationType": "BD",
                "regulatorCode": "LSX"
            },
            {
                "regulatorName": "Nasdaq Stock Market",
                "isCurrent": "YES",
                "registrationType": "BD",
                "regulatorCode": "NQX"
            },
            {
                "regulatorName": "Commodity Futures Trading Commission",
                "isCurrent": "YES",
                "registrationType": "BD",
                "regulatorCode": "CFTC"
            },
            {
                "regulatorName": "American Institute of Certified Public Accountants",
                "isCurrent": "YES",
                "registrationType": "BD",
                "regulatorCode": "PFS"
            },
            {
                "regulatorName": "New York Stock Exchange",
                "isCurrent": "YES",
                "registrationType": "BD",
                "regulatorCode": "NYSE"
            },
            {
                "regulatorName": "US Federal Trade Commission",
                "isCurrent": "YES",
                "registrationType": "BD",
                "regulatorCode": "FTC"
            },
            {
                "regulatorName": "Washington",
                "isCurrent": "YES",
                "registrationType": "BD",
                "regulatorCode": "WA"
            },
            {
                "regulatorName": "Tennessee",
                "isCurrent": "YES",
                "registrationType": "BD",
                "regulatorCode": "TN"
            },
            {
                "regulatorName": "California",
                "isCurrent": "YES",
                "registrationType": "BD",
                "regulatorCode": "CA"
            },
            {
                "regulatorName": "Chicago Climate Futures Exchange",
                "isCurrent": "YES",
                "registrationType": "BD",
                "regulatorCode": "CCFE"
            },
            {
                "regulatorName": "Idaho",
                "isCurrent": "YES",
                "registrationType": "BD",
                "regulatorCode": "ID"
            },
            {
                "regulatorName": "Chicago Board of Trade",
                "isCurrent": "YES",
                "registrationType": "BD",
                "regulatorCode": "CBOT"
            },
            {
                "regulatorName": "Cboe Exchange, Inc.",
                "isCurrent": "YES",
                "registrationType": "BD",
                "regulatorCode": "CBOE"
            },
            {
                "regulatorName": "Colorado",
                "isCurrent": "YES",
                "registrationType": "BD",
                "regulatorCode": "CO"
            },
            {
                "regulatorName": "Comptroller of the Currency",
                "isCurrent": "YES",
                "registrationType": "BD",
                "regulatorCode": "CC"
            },
            {
                "regulatorName": "Nasdaq BX, Inc.",
                "isCurrent": "YES",
                "registrationType": "BD",
                "regulatorCode": "BX"
            },
            {
                "regulatorName": "NASDAQ Futures Exchange",
                "isCurrent": "YES",
                "registrationType": "BD",
                "regulatorCode": "NFX"
            },
            {
                "regulatorName": "Nasdaq MRX, LLC",
                "isCurrent": "YES",
                "registrationType": "BD",
                "regulatorCode": "ISE MRX"
            },
            {
                "regulatorName": "FINRA ALTERNATIVE DISPLAY FACILITY",
                "isCurrent": "YES",
                "registrationType": "BD",
                "regulatorCode": "NADF"
            },
            {
                "regulatorName": "U.S. Postal Inspection Service",
                "isCurrent": "YES",
                "registrationType": "BD",
                "regulatorCode": "USPS"
            }
        ]
    }
]

 

Inactive Individual

Basic information about all individuals formerly employed by a firm.

Dataset Info:

group dataset test dataset
firm inactiveIndividual inactiveIndividualMock

 

Sample Request
https://api.finra.org/data/group/firm/name/inactiveIndividualMock?limit=5

 

Sample Response
[
    {
        "firstName": "LILLIE",
        "lastName": "FENNER",
        "registrations": [
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "BX"
            },
            {
                "regulatorCode": "NYSE-NAT"
            },
            {
                "regulatorCode": "PHLX"
            },
            {
                "regulatorCode": "NQX"
            },
            {
                "regulatorCode": "BOX"
            },
            {
                "regulatorCode": "IEX"
            },
            {
                "regulatorCode": "NY"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "NQX"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "NY"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "FINRA"
            }
        ],
        "otherNames": [
            {
                "firstName": "LILLIE",
                "lastName": "FENNER",
                "suffixName": null,
                "middleName": null
            }
        ],
        "suffixName": null,
        "middleName": "ESTHER",
        "employments": [
            {
                "firmCrdNumber": 79,
                "isActive": "NO"
            },
            {
                "firmCrdNumber": 152234,
                "isActive": "NO"
            },
            {
                "firmCrdNumber": 37909,
                "isActive": "NO"
            }
        ],
        "individualCrdNumber": 1000005
    },
    {
        "firstName": "DOUGLAS",
        "lastName": "BATES",
        "registrations": [
            {
                "regulatorCode": "AK"
            },
            {
                "regulatorCode": "AZ"
            },
            {
                "regulatorCode": "CA"
            },
            {
                "regulatorCode": "CO"
            },
            {
                "regulatorCode": "HI"
            },
            {
                "regulatorCode": "ID"
            },
            {
                "regulatorCode": "IL"
            },
            {
                "regulatorCode": "MA"
            },
            {
                "regulatorCode": "NV"
            },
            {
                "regulatorCode": "NJ"
            },
            {
                "regulatorCode": "NM"
            },
            {
                "regulatorCode": "NY"
            },
            {
                "regulatorCode": "OK"
            },
            {
                "regulatorCode": "OR"
            },
            {
                "regulatorCode": "UT"
            },
            {
                "regulatorCode": "WA"
            },
            {
                "regulatorCode": "WY"
            },
            {
                "regulatorCode": "NYSE-AMER"
            },
            {
                "regulatorCode": "NYSE"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "NYSE-AMER"
            },
            {
                "regulatorCode": "CBOE"
            },
            {
                "regulatorCode": "NYSE"
            },
            {
                "regulatorCode": "PHLX"
            },
            {
                "regulatorCode": "NYSE-ARCA"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "CBOE"
            },
            {
                "regulatorCode": "PHLX"
            },
            {
                "regulatorCode": "NYSE-ARCA"
            },
            {
                "regulatorCode": "ID"
            },
            {
                "regulatorCode": "ID"
            },
            {
                "regulatorCode": "CA"
            },
            {
                "regulatorCode": "ID"
            },
            {
                "regulatorCode": "FINRA"
            }
        ],
        "otherNames": [
            {
                "firstName": "DOUGHAS",
                "lastName": "BATES",
                "suffixName": null,
                "middleName": "K"
            }
        ],
        "suffixName": null,
        "middleName": "K",
        "employments": [
            {
                "firmCrdNumber": 153822,
                "isActive": "NO"
            },
            {
                "firmCrdNumber": 116865,
                "isActive": "NO"
            },
            {
                "firmCrdNumber": 109394,
                "isActive": "NO"
            },
            {
                "firmCrdNumber": 153822,
                "isActive": "NO"
            },
            {
                "firmCrdNumber": 361,
                "isActive": "NO"
            }
        ],
        "individualCrdNumber": 1000018
    },
    {
        "firstName": "EDGAR",
        "lastName": "ROBERTSON",
        "registrations": [
            {
                "regulatorCode": "AR"
            },
            {
                "regulatorCode": "CA"
            },
            {
                "regulatorCode": "CO"
            },
            {
                "regulatorCode": "FL"
            },
            {
                "regulatorCode": "GA"
            },
            {
                "regulatorCode": "LA"
            },
            {
                "regulatorCode": "NM"
            },
            {
                "regulatorCode": "NM"
            },
            {
                "regulatorCode": "OK"
            },
            {
                "regulatorCode": "OK"
            },
            {
                "regulatorCode": "TX"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "TX"
            },
            {
                "regulatorCode": "GA"
            },
            {
                "regulatorCode": "LA"
            },
            {
                "regulatorCode": "OK"
            },
            {
                "regulatorCode": "TX"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "TX"
            },
            {
                "regulatorCode": "GA"
            },
            {
                "regulatorCode": "LA"
            },
            {
                "regulatorCode": "OK"
            },
            {
                "regulatorCode": "TX"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "TX"
            }
        ],
        "otherNames": [
            {
                "firstName": "EDGAR",
                "lastName": "ROBERTSON",
                "suffixName": null,
                "middleName": "CHARLES JR"
            }
        ],
        "suffixName": "JR",
        "middleName": "CHARLES",
        "employments": [
            {
                "firmCrdNumber": 10409,
                "isActive": "NO"
            },
            {
                "firmCrdNumber": 615,
                "isActive": "NO"
            },
            {
                "firmCrdNumber": 14251,
                "isActive": "NO"
            }
        ],
        "individualCrdNumber": 1000048
    },
    {
        "firstName": "DENNIS",
        "lastName": "THAYER",
        "registrations": [
            {
                "regulatorCode": "KY"
            },
            {
                "regulatorCode": "OH"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "OH"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "CT"
            },
            {
                "regulatorCode": "OH"
            },
            {
                "regulatorCode": "OK"
            },
            {
                "regulatorCode": "PA"
            },
            {
                "regulatorCode": "PA"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "NQX"
            }
        ],
        "suffixName": null,
        "middleName": "NOEL",
        "employments": [
            {
                "firmCrdNumber": 5435,
                "isActive": "NO"
            },
            {
                "firmCrdNumber": 15840,
                "isActive": "NO"
            },
            {
                "firmCrdNumber": 115368,
                "isActive": "NO"
            }
        ],
        "individualCrdNumber": 1000057
    },
    {
        "firstName": "KENNETH",
        "lastName": "NIGG",
        "registrations": [
            {
                "regulatorCode": "AL"
            },
            {
                "regulatorCode": "AL"
            },
            {
                "regulatorCode": "AK"
            },
            {
                "regulatorCode": "AZ"
            },
            {
                "regulatorCode": "AR"
            },
            {
                "regulatorCode": "CA"
            },
            {
                "regulatorCode": "CO"
            },
            {
                "regulatorCode": "CT"
            },
            {
                "regulatorCode": "DE"
            },
            {
                "regulatorCode": "DC"
            },
            {
                "regulatorCode": "FL"
            },
            {
                "regulatorCode": "GA"
            },
            {
                "regulatorCode": "HI"
            },
            {
                "regulatorCode": "ID"
            },
            {
                "regulatorCode": "IL"
            },
            {
                "regulatorCode": "IN"
            },
            {
                "regulatorCode": "IA"
            },
            {
                "regulatorCode": "KS"
            },
            {
                "regulatorCode": "KY"
            },
            {
                "regulatorCode": "LA"
            },
            {
                "regulatorCode": "ME"
            },
            {
                "regulatorCode": "MD"
            },
            {
                "regulatorCode": "MA"
            },
            {
                "regulatorCode": "MI"
            },
            {
                "regulatorCode": "MN"
            },
            {
                "regulatorCode": "MS"
            },
            {
                "regulatorCode": "MO"
            },
            {
                "regulatorCode": "MT"
            },
            {
                "regulatorCode": "NE"
            },
            {
                "regulatorCode": "NV"
            },
            {
                "regulatorCode": "NH"
            },
            {
                "regulatorCode": "NJ"
            },
            {
                "regulatorCode": "NM"
            },
            {
                "regulatorCode": "NY"
            },
            {
                "regulatorCode": "NC"
            },
            {
                "regulatorCode": "ND"
            },
            {
                "regulatorCode": "OH"
            },
            {
                "regulatorCode": "OK"
            },
            {
                "regulatorCode": "OR"
            },
            {
                "regulatorCode": "PA"
            },
            {
                "regulatorCode": "PR"
            },
            {
                "regulatorCode": "RI"
            },
            {
                "regulatorCode": "SC"
            },
            {
                "regulatorCode": "SD"
            },
            {
                "regulatorCode": "TN"
            },
            {
                "regulatorCode": "TX"
            },
            {
                "regulatorCode": "UT"
            },
            {
                "regulatorCode": "VT"
            },
            {
                "regulatorCode": "VA"
            },
            {
                "regulatorCode": "WA"
            },
            {
                "regulatorCode": "WV"
            },
            {
                "regulatorCode": "WI"
            },
            {
                "regulatorCode": "WY"
            },
            {
                "regulatorCode": "NYSE-AMER"
            },
            {
                "regulatorCode": "NYSE-AMER"
            },
            {
                "regulatorCode": "NYSE"
            },
            {
                "regulatorCode": "NYSE"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "NYSE-AMER"
            },
            {
                "regulatorCode": "CBOE"
            },
            {
                "regulatorCode": "NYSE"
            },
            {
                "regulatorCode": "PHLX"
            },
            {
                "regulatorCode": "NYSE-ARCA"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "CBOE"
            },
            {
                "regulatorCode": "CBOE"
            },
            {
                "regulatorCode": "PHLX"
            },
            {
                "regulatorCode": "PHLX"
            },
            {
                "regulatorCode": "NYSE-ARCA"
            },
            {
                "regulatorCode": "NYSE-ARCA"
            },
            {
                "regulatorCode": "IN"
            },
            {
                "regulatorCode": "KY"
            },
            {
                "regulatorCode": "NY"
            },
            {
                "regulatorCode": "OH"
            },
            {
                "regulatorCode": "PA"
            },
            {
                "regulatorCode": "WV"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "NYSE"
            },
            {
                "regulatorCode": "IL"
            },
            {
                "regulatorCode": "KY"
            },
            {
                "regulatorCode": "OH"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "IN"
            },
            {
                "regulatorCode": "KY"
            },
            {
                "regulatorCode": "TX"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "AZ"
            },
            {
                "regulatorCode": "IL"
            },
            {
                "regulatorCode": "IN"
            },
            {
                "regulatorCode": "KY"
            },
            {
                "regulatorCode": "NJ"
            },
            {
                "regulatorCode": "NM"
            },
            {
                "regulatorCode": "TN"
            },
            {
                "regulatorCode": "TX"
            },
            {
                "regulatorCode": "CBOE"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "FINRA"
            }
        ],
        "otherNames": [
            {
                "firstName": "KENNETH",
                "lastName": "NIGG",
                "suffixName": null,
                "middleName": "JOE"
            },
            {
                "firstName": "KENNETH",
                "lastName": "NIGG",
                "suffixName": null,
                "middleName": null
            },
            {
                "firstName": "KEN",
                "lastName": "NIGG",
                "suffixName": null,
                "middleName": null
            },
            {
                "firstName": "KENNETH",
                "lastName": "NIGG",
                "suffixName": null,
                "middleName": null
            }
        ],
        "suffixName": null,
        "middleName": "JOE",
        "employments": [
            {
                "firmCrdNumber": 7784,
                "isActive": "NO"
            },
            {
                "firmCrdNumber": 5393,
                "isActive": "NO"
            },
            {
                "firmCrdNumber": 22305,
                "isActive": "NO"
            },
            {
                "firmCrdNumber": 104235,
                "isActive": "NO"
            },
            {
                "firmCrdNumber": 128605,
                "isActive": "NO"
            }
        ],
        "individualCrdNumber": 1000065
    }
]

 

Sample Request
https://api.finra.org/data/group/firm/name/inactiveIndividualMock

 

Sample Request Payload
{
"limit":2,
"fields":["firstName","lastName","individualCrdNumber","registrations.regulatorCode"]
}

 

Sample Response
[
    {
        "firstName": "LILLIE",
        "lastName": "FENNER",
        "registrations": [
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "BX"
            },
            {
                "regulatorCode": "NYSE-NAT"
            },
            {
                "regulatorCode": "PHLX"
            },
            {
                "regulatorCode": "NQX"
            },
            {
                "regulatorCode": "BOX"
            },
            {
                "regulatorCode": "IEX"
            },
            {
                "regulatorCode": "NY"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "NQX"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "NY"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "FINRA"
            }
        ],
        "individualCrdNumber": 1000005
    },
    {
        "firstName": "DOUGLAS",
        "lastName": "BATES",
        "registrations": [
            {
                "regulatorCode": "AK"
            },
            {
                "regulatorCode": "AZ"
            },
            {
                "regulatorCode": "CA"
            },
            {
                "regulatorCode": "CO"
            },
            {
                "regulatorCode": "HI"
            },
            {
                "regulatorCode": "ID"
            },
            {
                "regulatorCode": "IL"
            },
            {
                "regulatorCode": "MA"
            },
            {
                "regulatorCode": "NV"
            },
            {
                "regulatorCode": "NJ"
            },
            {
                "regulatorCode": "NM"
            },
            {
                "regulatorCode": "NY"
            },
            {
                "regulatorCode": "OK"
            },
            {
                "regulatorCode": "OR"
            },
            {
                "regulatorCode": "UT"
            },
            {
                "regulatorCode": "WA"
            },
            {
                "regulatorCode": "WY"
            },
            {
                "regulatorCode": "NYSE-AMER"
            },
            {
                "regulatorCode": "NYSE"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "NYSE-AMER"
            },
            {
                "regulatorCode": "CBOE"
            },
            {
                "regulatorCode": "NYSE"
            },
            {
                "regulatorCode": "PHLX"
            },
            {
                "regulatorCode": "NYSE-ARCA"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "CBOE"
            },
            {
                "regulatorCode": "PHLX"
            },
            {
                "regulatorCode": "NYSE-ARCA"
            },
            {
                "regulatorCode": "ID"
            },
            {
                "regulatorCode": "ID"
            },
            {
                "regulatorCode": "CA"
            },
            {
                "regulatorCode": "ID"
            },
            {
                "regulatorCode": "FINRA"
            }
        ],
        "individualCrdNumber": 1000018
    }
]

 

Inactive Individual Branch Office Locations

Branch information for all individuals formerly employed by a firm.

Dataset Info:

group dataset test dataset
firm inactiveIndividualBranchOfficeLocations inactiveIndividualBranchOfficeLocationsMock

 

Sample Request
https://api.finra.org/data/group/firm/name/inactiveIndividualBranchOfficeLocationsMock?limit=5

 

Sample Response
[
    {
        "registrations": [
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "BX"
            },
            {
                "regulatorCode": "NYSE-NAT"
            },
            {
                "regulatorCode": "PHLX"
            },
            {
                "regulatorCode": "NQX"
            },
            {
                "regulatorCode": "BOX"
            },
            {
                "regulatorCode": "IEX"
            },
            {
                "regulatorCode": "NY"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "NQX"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "NY"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "FINRA"
            }
        ],
        "branchOfficeLocations": [
            {
                "nonRegisteredBranchIdentifier": 6843192,
                "officeLocationEndDate": "2018-04-01",
                "firmCrdNumber": 79,
                "officeLocationStartDate": "2015-04-15",
                "officeLocationRoleText": "STAFF",
                "branchCrdNumber": null,
                "officeLocationType": "LOCATED AT"
            },
            {
                "nonRegisteredBranchIdentifier": null,
                "officeLocationEndDate": "2018-04-01",
                "firmCrdNumber": 79,
                "officeLocationStartDate": "2015-04-15",
                "officeLocationRoleText": "STAFF",
                "branchCrdNumber": 200878,
                "officeLocationType": "SUPERVISED FROM"
            },
            {
                "nonRegisteredBranchIdentifier": null,
                "officeLocationEndDate": "2013-07-31",
                "firmCrdNumber": 152234,
                "officeLocationStartDate": "2013-05-14",
                "officeLocationRoleText": "STAFF",
                "branchCrdNumber": 425558,
                "officeLocationType": "SUPERVISED FROM"
            },
            {
                "nonRegisteredBranchIdentifier": null,
                "officeLocationEndDate": "2012-01-30",
                "firmCrdNumber": 37909,
                "officeLocationStartDate": "2010-06-21",
                "officeLocationRoleText": "STAFF",
                "branchCrdNumber": 74306,
                "officeLocationType": "SUPERVISED FROM"
            }
        ],
        "individualCrdNumber": 1000005
    },
    {
        "registrations": [
            {
                "regulatorCode": "AK"
            },
            {
                "regulatorCode": "AZ"
            },
            {
                "regulatorCode": "CA"
            },
            {
                "regulatorCode": "CO"
            },
            {
                "regulatorCode": "HI"
            },
            {
                "regulatorCode": "ID"
            },
            {
                "regulatorCode": "IL"
            },
            {
                "regulatorCode": "MA"
            },
            {
                "regulatorCode": "NV"
            },
            {
                "regulatorCode": "NJ"
            },
            {
                "regulatorCode": "NM"
            },
            {
                "regulatorCode": "NY"
            },
            {
                "regulatorCode": "OK"
            },
            {
                "regulatorCode": "OR"
            },
            {
                "regulatorCode": "UT"
            },
            {
                "regulatorCode": "WA"
            },
            {
                "regulatorCode": "WY"
            },
            {
                "regulatorCode": "NYSE-AMER"
            },
            {
                "regulatorCode": "NYSE"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "NYSE-AMER"
            },
            {
                "regulatorCode": "CBOE"
            },
            {
                "regulatorCode": "NYSE"
            },
            {
                "regulatorCode": "PHLX"
            },
            {
                "regulatorCode": "NYSE-ARCA"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "CBOE"
            },
            {
                "regulatorCode": "PHLX"
            },
            {
                "regulatorCode": "NYSE-ARCA"
            },
            {
                "regulatorCode": "ID"
            },
            {
                "regulatorCode": "ID"
            },
            {
                "regulatorCode": "CA"
            },
            {
                "regulatorCode": "ID"
            },
            {
                "regulatorCode": "FINRA"
            }
        ],
        "branchOfficeLocations": [
            {
                "nonRegisteredBranchIdentifier": null,
                "officeLocationEndDate": "2013-03-07",
                "firmCrdNumber": 153822,
                "officeLocationStartDate": "2009-01-16",
                "officeLocationRoleText": "STAFF",
                "branchCrdNumber": 441807,
                "officeLocationType": "LOCATED AT"
            },
            {
                "nonRegisteredBranchIdentifier": null,
                "officeLocationEndDate": "2022-01-12",
                "firmCrdNumber": 116865,
                "officeLocationStartDate": "2001-09-01",
                "officeLocationRoleText": "STAFF",
                "branchCrdNumber": 60883,
                "officeLocationType": "LOCATED AT"
            },
            {
                "nonRegisteredBranchIdentifier": null,
                "officeLocationEndDate": "2010-04-14",
                "firmCrdNumber": 109394,
                "officeLocationStartDate": "1998-01-01",
                "officeLocationRoleText": "STAFF",
                "branchCrdNumber": 60884,
                "officeLocationType": "LOCATED AT"
            },
            {
                "nonRegisteredBranchIdentifier": 5743697,
                "officeLocationEndDate": "2010-06-08",
                "firmCrdNumber": 153822,
                "officeLocationStartDate": "2010-06-03",
                "officeLocationRoleText": "STAFF",
                "branchCrdNumber": null,
                "officeLocationType": "LOCATED AT"
            },
            {
                "nonRegisteredBranchIdentifier": 899490,
                "officeLocationEndDate": "1997-12-19",
                "firmCrdNumber": 361,
                "officeLocationStartDate": "1983-06-16",
                "officeLocationRoleText": "STAFF",
                "branchCrdNumber": null,
                "officeLocationType": "LOCATED AT"
            }
        ],
        "individualCrdNumber": 1000018
    },
    {
        "registrations": [
            {
                "regulatorCode": "AR"
            },
            {
                "regulatorCode": "CA"
            },
            {
                "regulatorCode": "CO"
            },
            {
                "regulatorCode": "FL"
            },
            {
                "regulatorCode": "GA"
            },
            {
                "regulatorCode": "LA"
            },
            {
                "regulatorCode": "NM"
            },
            {
                "regulatorCode": "NM"
            },
            {
                "regulatorCode": "OK"
            },
            {
                "regulatorCode": "OK"
            },
            {
                "regulatorCode": "TX"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "TX"
            },
            {
                "regulatorCode": "GA"
            },
            {
                "regulatorCode": "LA"
            },
            {
                "regulatorCode": "OK"
            },
            {
                "regulatorCode": "TX"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "TX"
            },
            {
                "regulatorCode": "GA"
            },
            {
                "regulatorCode": "LA"
            },
            {
                "regulatorCode": "OK"
            },
            {
                "regulatorCode": "TX"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "TX"
            }
        ],
        "branchOfficeLocations": [
            {
                "nonRegisteredBranchIdentifier": null,
                "officeLocationEndDate": "2018-05-25",
                "firmCrdNumber": 10409,
                "officeLocationStartDate": "2017-03-25",
                "officeLocationRoleText": "STAFF",
                "branchCrdNumber": 658989,
                "officeLocationType": "LOCATED AT"
            },
            {
                "nonRegisteredBranchIdentifier": null,
                "officeLocationEndDate": "2015-01-02",
                "firmCrdNumber": 615,
                "officeLocationStartDate": "2006-01-06",
                "officeLocationRoleText": "STAFF",
                "branchCrdNumber": 72084,
                "officeLocationType": "LOCATED AT"
            },
            {
                "nonRegisteredBranchIdentifier": 899580,
                "officeLocationEndDate": "2006-01-06",
                "firmCrdNumber": 615,
                "officeLocationStartDate": "1981-06-09",
                "officeLocationRoleText": "STAFF",
                "branchCrdNumber": null,
                "officeLocationType": "LOCATED AT"
            },
            {
                "nonRegisteredBranchIdentifier": null,
                "officeLocationEndDate": "2017-03-25",
                "firmCrdNumber": 14251,
                "officeLocationStartDate": "2015-01-02",
                "officeLocationRoleText": "STAFF",
                "branchCrdNumber": 165203,
                "officeLocationType": "LOCATED AT"
            }
        ],
        "individualCrdNumber": 1000048
    },
    {
        "registrations": [
            {
                "regulatorCode": "KY"
            },
            {
                "regulatorCode": "OH"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "OH"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "CT"
            },
            {
                "regulatorCode": "OH"
            },
            {
                "regulatorCode": "OK"
            },
            {
                "regulatorCode": "PA"
            },
            {
                "regulatorCode": "PA"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "NQX"
            }
        ],
        "branchOfficeLocations": [
            {
                "nonRegisteredBranchIdentifier": 899626,
                "officeLocationEndDate": "1998-11-25",
                "firmCrdNumber": 5435,
                "officeLocationStartDate": "1981-06-11",
                "officeLocationRoleText": "STAFF",
                "branchCrdNumber": null,
                "officeLocationType": "LOCATED AT"
            },
            {
                "nonRegisteredBranchIdentifier": 899629,
                "officeLocationEndDate": "2002-02-09",
                "firmCrdNumber": 15840,
                "officeLocationStartDate": "1999-01-04",
                "officeLocationRoleText": "STAFF",
                "branchCrdNumber": null,
                "officeLocationType": "LOCATED AT"
            },
            {
                "nonRegisteredBranchIdentifier": null,
                "officeLocationEndDate": "2016-09-05",
                "firmCrdNumber": 115368,
                "officeLocationStartDate": "2002-02-09",
                "officeLocationRoleText": "Person in Charge",
                "branchCrdNumber": 136782,
                "officeLocationType": "LOCATED AT"
            }
        ],
        "individualCrdNumber": 1000057
    },
    {
        "registrations": [
            {
                "regulatorCode": "AL"
            },
            {
                "regulatorCode": "AL"
            },
            {
                "regulatorCode": "AK"
            },
            {
                "regulatorCode": "AZ"
            },
            {
                "regulatorCode": "AR"
            },
            {
                "regulatorCode": "CA"
            },
            {
                "regulatorCode": "CO"
            },
            {
                "regulatorCode": "CT"
            },
            {
                "regulatorCode": "DE"
            },
            {
                "regulatorCode": "DC"
            },
            {
                "regulatorCode": "FL"
            },
            {
                "regulatorCode": "GA"
            },
            {
                "regulatorCode": "HI"
            },
            {
                "regulatorCode": "ID"
            },
            {
                "regulatorCode": "IL"
            },
            {
                "regulatorCode": "IN"
            },
            {
                "regulatorCode": "IA"
            },
            {
                "regulatorCode": "KS"
            },
            {
                "regulatorCode": "KY"
            },
            {
                "regulatorCode": "LA"
            },
            {
                "regulatorCode": "ME"
            },
            {
                "regulatorCode": "MD"
            },
            {
                "regulatorCode": "MA"
            },
            {
                "regulatorCode": "MI"
            },
            {
                "regulatorCode": "MN"
            },
            {
                "regulatorCode": "MS"
            },
            {
                "regulatorCode": "MO"
            },
            {
                "regulatorCode": "MT"
            },
            {
                "regulatorCode": "NE"
            },
            {
                "regulatorCode": "NV"
            },
            {
                "regulatorCode": "NH"
            },
            {
                "regulatorCode": "NJ"
            },
            {
                "regulatorCode": "NM"
            },
            {
                "regulatorCode": "NY"
            },
            {
                "regulatorCode": "NC"
            },
            {
                "regulatorCode": "ND"
            },
            {
                "regulatorCode": "OH"
            },
            {
                "regulatorCode": "OK"
            },
            {
                "regulatorCode": "OR"
            },
            {
                "regulatorCode": "PA"
            },
            {
                "regulatorCode": "PR"
            },
            {
                "regulatorCode": "RI"
            },
            {
                "regulatorCode": "SC"
            },
            {
                "regulatorCode": "SD"
            },
            {
                "regulatorCode": "TN"
            },
            {
                "regulatorCode": "TX"
            },
            {
                "regulatorCode": "UT"
            },
            {
                "regulatorCode": "VT"
            },
            {
                "regulatorCode": "VA"
            },
            {
                "regulatorCode": "WA"
            },
            {
                "regulatorCode": "WV"
            },
            {
                "regulatorCode": "WI"
            },
            {
                "regulatorCode": "WY"
            },
            {
                "regulatorCode": "NYSE-AMER"
            },
            {
                "regulatorCode": "NYSE-AMER"
            },
            {
                "regulatorCode": "NYSE"
            },
            {
                "regulatorCode": "NYSE"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "NYSE-AMER"
            },
            {
                "regulatorCode": "CBOE"
            },
            {
                "regulatorCode": "NYSE"
            },
            {
                "regulatorCode": "PHLX"
            },
            {
                "regulatorCode": "NYSE-ARCA"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "CBOE"
            },
            {
                "regulatorCode": "CBOE"
            },
            {
                "regulatorCode": "PHLX"
            },
            {
                "regulatorCode": "PHLX"
            },
            {
                "regulatorCode": "NYSE-ARCA"
            },
            {
                "regulatorCode": "NYSE-ARCA"
            },
            {
                "regulatorCode": "IN"
            },
            {
                "regulatorCode": "KY"
            },
            {
                "regulatorCode": "NY"
            },
            {
                "regulatorCode": "OH"
            },
            {
                "regulatorCode": "PA"
            },
            {
                "regulatorCode": "WV"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "NYSE"
            },
            {
                "regulatorCode": "IL"
            },
            {
                "regulatorCode": "KY"
            },
            {
                "regulatorCode": "OH"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "IN"
            },
            {
                "regulatorCode": "KY"
            },
            {
                "regulatorCode": "TX"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "AZ"
            },
            {
                "regulatorCode": "IL"
            },
            {
                "regulatorCode": "IN"
            },
            {
                "regulatorCode": "KY"
            },
            {
                "regulatorCode": "NJ"
            },
            {
                "regulatorCode": "NM"
            },
            {
                "regulatorCode": "TN"
            },
            {
                "regulatorCode": "TX"
            },
            {
                "regulatorCode": "CBOE"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "FINRA"
            }
        ],
        "branchOfficeLocations": [
            {
                "nonRegisteredBranchIdentifier": 899664,
                "officeLocationEndDate": "1992-01-01",
                "firmCrdNumber": 7784,
                "officeLocationStartDate": "1986-08-18",
                "officeLocationRoleText": "STAFF",
                "branchCrdNumber": null,
                "officeLocationType": "LOCATED AT"
            },
            {
                "nonRegisteredBranchIdentifier": 899661,
                "officeLocationEndDate": "2003-07-17",
                "firmCrdNumber": 5393,
                "officeLocationStartDate": "1993-01-18",
                "officeLocationRoleText": "STAFF",
                "branchCrdNumber": null,
                "officeLocationType": "LOCATED AT"
            },
            {
                "nonRegisteredBranchIdentifier": 899667,
                "officeLocationEndDate": "1992-10-20",
                "firmCrdNumber": 22305,
                "officeLocationStartDate": "1992-01-20",
                "officeLocationRoleText": "STAFF",
                "branchCrdNumber": null,
                "officeLocationType": "LOCATED AT"
            },
            {
                "nonRegisteredBranchIdentifier": 899671,
                "officeLocationEndDate": "2004-05-28",
                "firmCrdNumber": 104235,
                "officeLocationStartDate": "2003-09-19",
                "officeLocationRoleText": "STAFF",
                "branchCrdNumber": null,
                "officeLocationType": "LOCATED AT"
            },
            {
                "nonRegisteredBranchIdentifier": null,
                "officeLocationEndDate": "2015-07-22",
                "firmCrdNumber": 128605,
                "officeLocationStartDate": "2006-08-14",
                "officeLocationRoleText": "STAFF",
                "branchCrdNumber": 298880,
                "officeLocationType": "LOCATED AT"
            },
            {
                "nonRegisteredBranchIdentifier": null,
                "officeLocationEndDate": "2019-11-22",
                "firmCrdNumber": 128605,
                "officeLocationStartDate": "2004-05-28",
                "officeLocationRoleText": "STAFF",
                "branchCrdNumber": 131206,
                "officeLocationType": "LOCATED AT"
            }
        ],
        "individualCrdNumber": 1000065
    }
]

 

Sample Request
https://api.finra.org/data/group/firm/name/inactiveIndividualBranchOfficeLocationsMock

 

Sample Request Payload
{
"limit":2,
"fields":["individualCrdNumber","registrations.regulatorCode","branchOfficeLocations.firmCrdNumber",
"branchOfficeLocations.branchCrdNumber"]
}
 

 

Sample Response
[
    {
        "registrations": [
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "BX"
            },
            {
                "regulatorCode": "NYSE-NAT"
            },
            {
                "regulatorCode": "PHLX"
            },
            {
                "regulatorCode": "NQX"
            },
            {
                "regulatorCode": "BOX"
            },
            {
                "regulatorCode": "IEX"
            },
            {
                "regulatorCode": "NY"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "NQX"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "NY"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "FINRA"
            }
        ],
        "branchOfficeLocations": [
            {
                "firmCrdNumber": 79,
                "branchCrdNumber": null
            },
            {
                "firmCrdNumber": 79,
                "branchCrdNumber": 200878
            },
            {
                "firmCrdNumber": 152234,
                "branchCrdNumber": 425558
            },
            {
                "firmCrdNumber": 37909,
                "branchCrdNumber": 74306
            }
        ],
        "individualCrdNumber": 1000005
    },
    {
        "registrations": [
            {
                "regulatorCode": "AK"
            },
            {
                "regulatorCode": "AZ"
            },
            {
                "regulatorCode": "CA"
            },
            {
                "regulatorCode": "CO"
            },
            {
                "regulatorCode": "HI"
            },
            {
                "regulatorCode": "ID"
            },
            {
                "regulatorCode": "IL"
            },
            {
                "regulatorCode": "MA"
            },
            {
                "regulatorCode": "NV"
            },
            {
                "regulatorCode": "NJ"
            },
            {
                "regulatorCode": "NM"
            },
            {
                "regulatorCode": "NY"
            },
            {
                "regulatorCode": "OK"
            },
            {
                "regulatorCode": "OR"
            },
            {
                "regulatorCode": "UT"
            },
            {
                "regulatorCode": "WA"
            },
            {
                "regulatorCode": "WY"
            },
            {
                "regulatorCode": "NYSE-AMER"
            },
            {
                "regulatorCode": "NYSE"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "NYSE-AMER"
            },
            {
                "regulatorCode": "CBOE"
            },
            {
                "regulatorCode": "NYSE"
            },
            {
                "regulatorCode": "PHLX"
            },
            {
                "regulatorCode": "NYSE-ARCA"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "CBOE"
            },
            {
                "regulatorCode": "PHLX"
            },
            {
                "regulatorCode": "NYSE-ARCA"
            },
            {
                "regulatorCode": "ID"
            },
            {
                "regulatorCode": "ID"
            },
            {
                "regulatorCode": "CA"
            },
            {
                "regulatorCode": "ID"
            },
            {
                "regulatorCode": "FINRA"
            }
        ],
        "branchOfficeLocations": [
            {
                "firmCrdNumber": 153822,
                "branchCrdNumber": 441807
            },
            {
                "firmCrdNumber": 116865,
                "branchCrdNumber": 60883
            },
            {
                "firmCrdNumber": 109394,
                "branchCrdNumber": 60884
            },
            {
                "firmCrdNumber": 153822,
                "branchCrdNumber": null
            },
            {
                "firmCrdNumber": 361,
                "branchCrdNumber": null
            }
        ],
        "individualCrdNumber": 1000018
    }
]

 

Inactive Individual Employments

Employment information for all indivdiuals formely employed by a firm.

Dataset Info:

group dataset test dataset
firm inactiveIndividualEmployments inactiveIndividualEmploymentsMock

 

Sample Request
https://api.finra.org/data/group/firm/name/inactiveIndividualEmploymentsMock?limit=5

 

Sample Response
[
    {
        "registrations": [
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "BX"
            },
            {
                "regulatorCode": "NYSE-NAT"
            },
            {
                "regulatorCode": "PHLX"
            },
            {
                "regulatorCode": "NQX"
            },
            {
                "regulatorCode": "BOX"
            },
            {
                "regulatorCode": "IEX"
            },
            {
                "regulatorCode": "NY"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "NQX"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "NY"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "FINRA"
            }
        ],
        "employments": [
            {
                "employmentStartDate": "2015-04-15",
                "terminationReasonCode": "OTHER",
                "independentContractorFlag": "NO",
                "terminationFiling": {
                    "filingDate": "2018-04-25",
                    "filingType": "FULL"
                },
                "individualBillingCode": "JPM-OPS",
                "employmentEndDate": "2018-04-01",
                "firmCrdNumber": 79,
                "isActive": "NO",
                "terminationReasonDescription": "Position No Longer Requires Registration",
                "employmentTypeCode": ""
            },
            {
                "employmentStartDate": "2013-05-14",
                "terminationReasonCode": "VOLUNTARY",
                "independentContractorFlag": "YES",
                "terminationFiling": {
                    "filingDate": "2013-07-31",
                    "filingType": "FULL"
                },
                "individualBillingCode": null,
                "employmentEndDate": "2013-07-31",
                "firmCrdNumber": 152234,
                "isActive": "NO",
                "terminationReasonDescription": "FIRM CEASED OPERATIONS",
                "employmentTypeCode": ""
            },
            {
                "employmentStartDate": "2010-06-21",
                "terminationReasonCode": "DISCHARGE",
                "independentContractorFlag": "YES",
                "terminationFiling": {
                    "filingDate": "2012-02-06",
                    "filingType": "FULL"
                },
                "individualBillingCode": "37909",
                "employmentEndDate": "2012-01-30",
                "firmCrdNumber": 37909,
                "isActive": "NO",
                "terminationReasonDescription": "FIRM SUSPENDED OPERATIONS",
                "employmentTypeCode": ""
            }
        ],
        "individualCrdNumber": 1000005
    },
    {
        "registrations": [
            {
                "regulatorCode": "AK"
            },
            {
                "regulatorCode": "AZ"
            },
            {
                "regulatorCode": "CA"
            },
            {
                "regulatorCode": "CO"
            },
            {
                "regulatorCode": "HI"
            },
            {
                "regulatorCode": "ID"
            },
            {
                "regulatorCode": "IL"
            },
            {
                "regulatorCode": "MA"
            },
            {
                "regulatorCode": "NV"
            },
            {
                "regulatorCode": "NJ"
            },
            {
                "regulatorCode": "NM"
            },
            {
                "regulatorCode": "NY"
            },
            {
                "regulatorCode": "OK"
            },
            {
                "regulatorCode": "OR"
            },
            {
                "regulatorCode": "UT"
            },
            {
                "regulatorCode": "WA"
            },
            {
                "regulatorCode": "WY"
            },
            {
                "regulatorCode": "NYSE-AMER"
            },
            {
                "regulatorCode": "NYSE"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "NYSE-AMER"
            },
            {
                "regulatorCode": "CBOE"
            },
            {
                "regulatorCode": "NYSE"
            },
            {
                "regulatorCode": "PHLX"
            },
            {
                "regulatorCode": "NYSE-ARCA"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "CBOE"
            },
            {
                "regulatorCode": "PHLX"
            },
            {
                "regulatorCode": "NYSE-ARCA"
            },
            {
                "regulatorCode": "ID"
            },
            {
                "regulatorCode": "ID"
            },
            {
                "regulatorCode": "CA"
            },
            {
                "regulatorCode": "ID"
            },
            {
                "regulatorCode": "FINRA"
            }
        ],
        "employments": [
            {
                "employmentStartDate": "2009-01-16",
                "terminationReasonCode": null,
                "independentContractorFlag": "NO",
                "individualBillingCode": null,
                "employmentEndDate": "2013-05-06",
                "firmCrdNumber": 153822,
                "isActive": "NO",
                "terminationReasonDescription": null,
                "employmentTypeCode": ""
            },
            {
                "employmentStartDate": "2001-09-01",
                "terminationReasonCode": "VOLUNTARY",
                "independentContractorFlag": "NO",
                "terminationFiling": {
                    "filingDate": "2022-01-12",
                    "filingType": "FULL"
                },
                "individualBillingCode": null,
                "employmentEndDate": "2022-01-12",
                "firmCrdNumber": 116865,
                "isActive": "NO",
                "terminationReasonDescription": null,
                "employmentTypeCode": ""
            },
            {
                "employmentStartDate": "1998-01-01",
                "terminationReasonCode": null,
                "independentContractorFlag": "NO",
                "individualBillingCode": null,
                "employmentEndDate": "2010-04-14",
                "firmCrdNumber": 109394,
                "isActive": "NO",
                "terminationReasonDescription": null,
                "employmentTypeCode": ""
            },
            {
                "employmentStartDate": "2010-06-03",
                "terminationReasonCode": null,
                "independentContractorFlag": null,
                "individualBillingCode": null,
                "employmentEndDate": "2010-06-08",
                "firmCrdNumber": 153822,
                "isActive": "NO",
                "terminationReasonDescription": null,
                "employmentTypeCode": "NON-REGISTERED FINGERPRINT INDIVIDUAL"
            },
            {
                "employmentStartDate": "1983-06-16",
                "terminationReasonCode": "VOLUNTARY",
                "independentContractorFlag": "NO",
                "individualBillingCode": null,
                "employmentEndDate": "1997-12-19",
                "firmCrdNumber": 361,
                "isActive": "NO",
                "terminationReasonDescription": null,
                "employmentTypeCode": ""
            }
        ],
        "individualCrdNumber": 1000018
    },
    {
        "registrations": [
            {
                "regulatorCode": "AR"
            },
            {
                "regulatorCode": "CA"
            },
            {
                "regulatorCode": "CO"
            },
            {
                "regulatorCode": "FL"
            },
            {
                "regulatorCode": "GA"
            },
            {
                "regulatorCode": "LA"
            },
            {
                "regulatorCode": "NM"
            },
            {
                "regulatorCode": "NM"
            },
            {
                "regulatorCode": "OK"
            },
            {
                "regulatorCode": "OK"
            },
            {
                "regulatorCode": "TX"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "TX"
            },
            {
                "regulatorCode": "GA"
            },
            {
                "regulatorCode": "LA"
            },
            {
                "regulatorCode": "OK"
            },
            {
                "regulatorCode": "TX"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "TX"
            },
            {
                "regulatorCode": "GA"
            },
            {
                "regulatorCode": "LA"
            },
            {
                "regulatorCode": "OK"
            },
            {
                "regulatorCode": "TX"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "TX"
            }
        ],
        "employments": [
            {
                "employmentStartDate": "2017-03-25",
                "terminationReasonCode": "VOLUNTARY",
                "independentContractorFlag": "YES",
                "terminationFiling": {
                    "filingDate": "2018-05-30",
                    "filingType": "FULL"
                },
                "individualBillingCode": "83K",
                "employmentEndDate": "2018-05-25",
                "firmCrdNumber": 10409,
                "isActive": "NO",
                "terminationReasonDescription": null,
                "employmentTypeCode": ""
            },
            {
                "employmentStartDate": "1981-06-09",
                "terminationReasonCode": "VOLUNTARY",
                "independentContractorFlag": "YES",
                "individualBillingCode": "127",
                "employmentEndDate": "2015-01-02",
                "firmCrdNumber": 615,
                "isActive": "NO",
                "terminationReasonDescription": "MASS TRANSFER = 168529",
                "employmentTypeCode": ""
            },
            {
                "employmentStartDate": "2015-01-02",
                "terminationReasonCode": "VOLUNTARY",
                "independentContractorFlag": "NO",
                "individualBillingCode": "83K",
                "employmentEndDate": "2017-03-25",
                "firmCrdNumber": 14251,
                "isActive": "NO",
                "terminationReasonDescription": "MASS TRANSFER = 45983604",
                "employmentTypeCode": ""
            }
        ],
        "individualCrdNumber": 1000048
    },
    {
        "registrations": [
            {
                "regulatorCode": "KY"
            },
            {
                "regulatorCode": "OH"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "OH"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "CT"
            },
            {
                "regulatorCode": "OH"
            },
            {
                "regulatorCode": "OK"
            },
            {
                "regulatorCode": "PA"
            },
            {
                "regulatorCode": "PA"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "NQX"
            }
        ],
        "employments": [
            {
                "employmentStartDate": "1981-06-11",
                "terminationReasonCode": "OTHER",
                "independentContractorFlag": "NO",
                "individualBillingCode": null,
                "employmentEndDate": "1998-11-25",
                "firmCrdNumber": 5435,
                "isActive": "NO",
                "terminationReasonDescription": "NONDISCIPILINARY TERMINATION PURSUANT TO THETERMS OF THE CONTRACT.",
                "employmentTypeCode": ""
            },
            {
                "employmentStartDate": "1999-01-04",
                "terminationReasonCode": null,
                "independentContractorFlag": "NO",
                "individualBillingCode": "1617",
                "employmentEndDate": "2002-02-09",
                "firmCrdNumber": 15840,
                "isActive": "NO",
                "terminationReasonDescription": null,
                "employmentTypeCode": ""
            },
            {
                "employmentStartDate": "2002-02-09",
                "terminationReasonCode": "DECEASED",
                "independentContractorFlag": "YES",
                "terminationFiling": {
                    "filingDate": "2016-09-15",
                    "filingType": "FULL"
                },
                "individualBillingCode": "1617",
                "employmentEndDate": "2016-09-05",
                "firmCrdNumber": 115368,
                "isActive": "NO",
                "terminationReasonDescription": null,
                "employmentTypeCode": ""
            }
        ],
        "individualCrdNumber": 1000057
    },
    {
        "registrations": [
            {
                "regulatorCode": "AL"
            },
            {
                "regulatorCode": "AL"
            },
            {
                "regulatorCode": "AK"
            },
            {
                "regulatorCode": "AZ"
            },
            {
                "regulatorCode": "AR"
            },
            {
                "regulatorCode": "CA"
            },
            {
                "regulatorCode": "CO"
            },
            {
                "regulatorCode": "CT"
            },
            {
                "regulatorCode": "DE"
            },
            {
                "regulatorCode": "DC"
            },
            {
                "regulatorCode": "FL"
            },
            {
                "regulatorCode": "GA"
            },
            {
                "regulatorCode": "HI"
            },
            {
                "regulatorCode": "ID"
            },
            {
                "regulatorCode": "IL"
            },
            {
                "regulatorCode": "IN"
            },
            {
                "regulatorCode": "IA"
            },
            {
                "regulatorCode": "KS"
            },
            {
                "regulatorCode": "KY"
            },
            {
                "regulatorCode": "LA"
            },
            {
                "regulatorCode": "ME"
            },
            {
                "regulatorCode": "MD"
            },
            {
                "regulatorCode": "MA"
            },
            {
                "regulatorCode": "MI"
            },
            {
                "regulatorCode": "MN"
            },
            {
                "regulatorCode": "MS"
            },
            {
                "regulatorCode": "MO"
            },
            {
                "regulatorCode": "MT"
            },
            {
                "regulatorCode": "NE"
            },
            {
                "regulatorCode": "NV"
            },
            {
                "regulatorCode": "NH"
            },
            {
                "regulatorCode": "NJ"
            },
            {
                "regulatorCode": "NM"
            },
            {
                "regulatorCode": "NY"
            },
            {
                "regulatorCode": "NC"
            },
            {
                "regulatorCode": "ND"
            },
            {
                "regulatorCode": "OH"
            },
            {
                "regulatorCode": "OK"
            },
            {
                "regulatorCode": "OR"
            },
            {
                "regulatorCode": "PA"
            },
            {
                "regulatorCode": "PR"
            },
            {
                "regulatorCode": "RI"
            },
            {
                "regulatorCode": "SC"
            },
            {
                "regulatorCode": "SD"
            },
            {
                "regulatorCode": "TN"
            },
            {
                "regulatorCode": "TX"
            },
            {
                "regulatorCode": "UT"
            },
            {
                "regulatorCode": "VT"
            },
            {
                "regulatorCode": "VA"
            },
            {
                "regulatorCode": "WA"
            },
            {
                "regulatorCode": "WV"
            },
            {
                "regulatorCode": "WI"
            },
            {
                "regulatorCode": "WY"
            },
            {
                "regulatorCode": "NYSE-AMER"
            },
            {
                "regulatorCode": "NYSE-AMER"
            },
            {
                "regulatorCode": "NYSE"
            },
            {
                "regulatorCode": "NYSE"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "NYSE-AMER"
            },
            {
                "regulatorCode": "CBOE"
            },
            {
                "regulatorCode": "NYSE"
            },
            {
                "regulatorCode": "PHLX"
            },
            {
                "regulatorCode": "NYSE-ARCA"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "CBOE"
            },
            {
                "regulatorCode": "CBOE"
            },
            {
                "regulatorCode": "PHLX"
            },
            {
                "regulatorCode": "PHLX"
            },
            {
                "regulatorCode": "NYSE-ARCA"
            },
            {
                "regulatorCode": "NYSE-ARCA"
            },
            {
                "regulatorCode": "IN"
            },
            {
                "regulatorCode": "KY"
            },
            {
                "regulatorCode": "NY"
            },
            {
                "regulatorCode": "OH"
            },
            {
                "regulatorCode": "PA"
            },
            {
                "regulatorCode": "WV"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "NYSE"
            },
            {
                "regulatorCode": "IL"
            },
            {
                "regulatorCode": "KY"
            },
            {
                "regulatorCode": "OH"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "IN"
            },
            {
                "regulatorCode": "KY"
            },
            {
                "regulatorCode": "TX"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "AZ"
            },
            {
                "regulatorCode": "IL"
            },
            {
                "regulatorCode": "IN"
            },
            {
                "regulatorCode": "KY"
            },
            {
                "regulatorCode": "NJ"
            },
            {
                "regulatorCode": "NM"
            },
            {
                "regulatorCode": "TN"
            },
            {
                "regulatorCode": "TX"
            },
            {
                "regulatorCode": "CBOE"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "FINRA"
            }
        ],
        "employments": [
            {
                "employmentStartDate": "1986-08-18",
                "terminationReasonCode": "VOLUNTARY",
                "independentContractorFlag": "NO",
                "individualBillingCode": "123",
                "employmentEndDate": "1992-01-01",
                "firmCrdNumber": 7784,
                "isActive": "NO",
                "terminationReasonDescription": null,
                "employmentTypeCode": ""
            },
            {
                "employmentStartDate": "1993-01-18",
                "terminationReasonCode": "VOLUNTARY",
                "independentContractorFlag": "NO",
                "terminationFiling": {
                    "filingDate": "2003-08-05",
                    "filingType": "FULL"
                },
                "individualBillingCode": "506",
                "employmentEndDate": "2003-07-17",
                "firmCrdNumber": 5393,
                "isActive": "NO",
                "terminationReasonDescription": null,
                "employmentTypeCode": ""
            },
            {
                "employmentStartDate": "1992-01-20",
                "terminationReasonCode": "VOLUNTARY",
                "independentContractorFlag": "NO",
                "individualBillingCode": "200",
                "employmentEndDate": "1992-10-20",
                "firmCrdNumber": 22305,
                "isActive": "NO",
                "terminationReasonDescription": "Voluntary",
                "employmentTypeCode": ""
            },
            {
                "employmentStartDate": "2003-09-19",
                "terminationReasonCode": "VOLUNTARY",
                "independentContractorFlag": "NO",
                "terminationFiling": {
                    "filingDate": "2004-05-28",
                    "filingType": "FULL"
                },
                "individualBillingCode": "CHIL12",
                "employmentEndDate": "2004-05-28",
                "firmCrdNumber": 104235,
                "isActive": "NO",
                "terminationReasonDescription": null,
                "employmentTypeCode": ""
            },
            {
                "employmentStartDate": "2004-05-28",
                "terminationReasonCode": "VOLUNTARY",
                "independentContractorFlag": "YES",
                "terminationFiling": {
                    "filingDate": "2019-11-25",
                    "filingType": "FULL"
                },
                "individualBillingCode": null,
                "employmentEndDate": "2019-11-22",
                "firmCrdNumber": 128605,
                "isActive": "NO",
                "terminationReasonDescription": null,
                "employmentTypeCode": ""
            }
        ],
        "individualCrdNumber": 1000065
    }
]

 

Sample Request
https://api.finra.org/data/group/firm/name/inactiveIndividualEmploymentsMock

 

Sample Request Payload
{
"limit":2,
"fields":["individualCrdNumber","registrations.regulatorCode","employments.terminationReasonDescription"]
}
 

 

Sample Response
[
    {
        "registrations": [
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "BX"
            },
            {
                "regulatorCode": "NYSE-NAT"
            },
            {
                "regulatorCode": "PHLX"
            },
            {
                "regulatorCode": "NQX"
            },
            {
                "regulatorCode": "BOX"
            },
            {
                "regulatorCode": "IEX"
            },
            {
                "regulatorCode": "NY"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "NQX"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "NY"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "FINRA"
            }
        ],
        "employments": [
            {
                "terminationReasonDescription": "Position No Longer Requires Registration"
            },
            {
                "terminationReasonDescription": "FIRM CEASED OPERATIONS"
            },
            {
                "terminationReasonDescription": "FIRM SUSPENDED OPERATIONS"
            }
        ],
        "individualCrdNumber": 1000005
    },
    {
        "registrations": [
            {
                "regulatorCode": "AK"
            },
            {
                "regulatorCode": "AZ"
            },
            {
                "regulatorCode": "CA"
            },
            {
                "regulatorCode": "CO"
            },
            {
                "regulatorCode": "HI"
            },
            {
                "regulatorCode": "ID"
            },
            {
                "regulatorCode": "IL"
            },
            {
                "regulatorCode": "MA"
            },
            {
                "regulatorCode": "NV"
            },
            {
                "regulatorCode": "NJ"
            },
            {
                "regulatorCode": "NM"
            },
            {
                "regulatorCode": "NY"
            },
            {
                "regulatorCode": "OK"
            },
            {
                "regulatorCode": "OR"
            },
            {
                "regulatorCode": "UT"
            },
            {
                "regulatorCode": "WA"
            },
            {
                "regulatorCode": "WY"
            },
            {
                "regulatorCode": "NYSE-AMER"
            },
            {
                "regulatorCode": "NYSE"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "NYSE-AMER"
            },
            {
                "regulatorCode": "CBOE"
            },
            {
                "regulatorCode": "NYSE"
            },
            {
                "regulatorCode": "PHLX"
            },
            {
                "regulatorCode": "NYSE-ARCA"
            },
            {
                "regulatorCode": "FINRA"
            },
            {
                "regulatorCode": "CBOE"
            },
            {
                "regulatorCode": "PHLX"
            },
            {
                "regulatorCode": "NYSE-ARCA"
            },
            {
                "regulatorCode": "ID"
            },
            {
                "regulatorCode": "ID"
            },
            {
                "regulatorCode": "CA"
            },
            {
                "regulatorCode": "ID"
            },
            {
                "regulatorCode": "FINRA"
            }
        ],
        "employments": [
            {
                "terminationReasonDescription": null
            },
            {
                "terminationReasonDescription": null
            },
            {
                "terminationReasonDescription": null
            },
            {
                "terminationReasonDescription": null
            },
            {
                "terminationReasonDescription": null
            }
        ],
        "individualCrdNumber": 1000018
    }
]

 

Inactive Individual Registration Status History

Registration status history for all individuals formerly employed by a firm.

Dataset Info:

group dataset test dataset
firm inactiveIndividualRegistrationStatusHistory inactiveIndividualRegistrationStatusHistoryMock

 

Sample Request
https://api.finra.org/data/group/firm/name/inactiveIndividualRegistrationStatusHistoryMock?limit=2

 

Sample Response
[
    {
        "registrationStatusHistory": [
            {
                "regulatorName": "FINRA",
                "registrationStatusCode": "DEFICIENT",
                "registrationCategoryName": "Investment Banking Representative",
                "registrationCategoryCode": "IB",
                "registrationStatusName": "Deficient",
                "regulatorCode": "FINRA",
                "firmCrdNumber": 37909,
                "firmName": "KAUFMAN BROS., L.P.",
                "statusEffectiveDate": "2010-06-22"
            },
            {
                "regulatorName": "New York",
                "registrationStatusCode": "DEFICIENT",
                "registrationCategoryName": "Agent",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Deficient",
                "regulatorCode": "NY",
                "firmCrdNumber": 37909,
                "firmName": "KAUFMAN BROS., L.P.",
                "statusEffectiveDate": "2010-06-22"
            },
            {
                "regulatorName": "FINRA",
                "registrationStatusCode": "APPRNT",
                "registrationCategoryName": "Investment Banking Representative",
                "registrationCategoryCode": "IB",
                "registrationStatusName": "Approved Pending Prints",
                "regulatorCode": "FINRA",
                "firmCrdNumber": 37909,
                "firmName": "KAUFMAN BROS., L.P.",
                "statusEffectiveDate": "2010-06-30"
            },
            {
                "regulatorName": "FINRA",
                "registrationStatusCode": "APRSLTS",
                "registrationCategoryName": "Investment Banking Representative",
                "registrationCategoryCode": "IB",
                "registrationStatusName": "Approved Pending Results",
                "regulatorCode": "FINRA",
                "firmCrdNumber": 37909,
                "firmName": "KAUFMAN BROS., L.P.",
                "statusEffectiveDate": "2010-07-09"
            },
            {
                "regulatorName": "FINRA",
                "registrationStatusCode": "APPROVED",
                "registrationCategoryName": "Investment Banking Representative",
                "registrationCategoryCode": "IB",
                "registrationStatusName": "Approved",
                "regulatorCode": "FINRA",
                "firmCrdNumber": 37909,
                "firmName": "KAUFMAN BROS., L.P.",
                "statusEffectiveDate": "2010-07-09"
            },
            {
                "regulatorName": "FINRA",
                "registrationStatusCode": "DEFICIENT",
                "registrationCategoryName": "General Securities Representative",
                "registrationCategoryCode": "GS",
                "registrationStatusName": "Deficient",
                "regulatorCode": "FINRA",
                "firmCrdNumber": 37909,
                "firmName": "KAUFMAN BROS., L.P.",
                "statusEffectiveDate": "2010-07-13"
            },
            {
                "regulatorName": "FINRA",
                "registrationStatusCode": "T_NOREG",
                "registrationCategoryName": "Research Analyst",
                "registrationCategoryCode": "RS",
                "registrationStatusName": "Termed Without Registration",
                "regulatorCode": "FINRA",
                "firmCrdNumber": 37909,
                "firmName": "KAUFMAN BROS., L.P.",
                "statusEffectiveDate": "2012-02-06"
            },
            {
                "regulatorName": "FINRA",
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Investment Banking Representative",
                "registrationCategoryCode": "IB",
                "registrationStatusName": "Termed",
                "regulatorCode": "FINRA",
                "firmCrdNumber": 37909,
                "firmName": "KAUFMAN BROS., L.P.",
                "statusEffectiveDate": "2012-02-06"
            },
            {
                "regulatorName": "Nasdaq Stock Market",
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "General Securities Representative",
                "registrationCategoryCode": "GS",
                "registrationStatusName": "Termed",
                "regulatorCode": "NQX",
                "firmCrdNumber": 37909,
                "firmName": "KAUFMAN BROS., L.P.",
                "statusEffectiveDate": "2012-02-06"
            },
            {
                "regulatorName": "FINRA",
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "General Securities Representative",
                "registrationCategoryCode": "GS",
                "registrationStatusName": "Termed",
                "regulatorCode": "FINRA",
                "firmCrdNumber": 37909,
                "firmName": "KAUFMAN BROS., L.P.",
                "statusEffectiveDate": "2012-02-06"
            },
            {
                "regulatorName": "New York",
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Agent",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Termed",
                "regulatorCode": "NY",
                "firmCrdNumber": 37909,
                "firmName": "KAUFMAN BROS., L.P.",
                "statusEffectiveDate": "2012-02-06"
            },
            {
                "regulatorName": "FINRA",
                "registrationStatusCode": "DEFICIENT",
                "registrationCategoryName": "General Securities Representative",
                "registrationCategoryCode": "GS",
                "registrationStatusName": "Deficient",
                "regulatorCode": "FINRA",
                "firmCrdNumber": 152234,
                "firmName": "WELBORN CAPITAL LLC",
                "statusEffectiveDate": "2013-05-14"
            },
            {
                "regulatorName": "FINRA",
                "registrationStatusCode": "DEFICIENT",
                "registrationCategoryName": "Investment Banking Representative",
                "registrationCategoryCode": "IB",
                "registrationStatusName": "Deficient",
                "regulatorCode": "FINRA",
                "firmCrdNumber": 152234,
                "firmName": "WELBORN CAPITAL LLC",
                "statusEffectiveDate": "2013-05-14"
            },
            {
                "regulatorName": "FINRA",
                "registrationStatusCode": "DEFICIENT",
                "registrationCategoryName": "Research Principal",
                "registrationCategoryCode": "RP",
                "registrationStatusName": "Deficient",
                "regulatorCode": "FINRA",
                "firmCrdNumber": 152234,
                "firmName": "WELBORN CAPITAL LLC",
                "statusEffectiveDate": "2013-05-14"
            },
            {
                "regulatorName": "New York",
                "registrationStatusCode": "DEFICIENT",
                "registrationCategoryName": "Agent",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Deficient",
                "regulatorCode": "NY",
                "firmCrdNumber": 152234,
                "firmName": "WELBORN CAPITAL LLC",
                "statusEffectiveDate": "2013-05-14"
            },
            {
                "regulatorName": "FINRA",
                "registrationStatusCode": "APPROVED",
                "registrationCategoryName": "General Securities Representative",
                "registrationCategoryCode": "GS",
                "registrationStatusName": "Approved",
                "regulatorCode": "FINRA",
                "firmCrdNumber": 37909,
                "firmName": "KAUFMAN BROS., L.P.",
                "statusEffectiveDate": "2010-08-18"
            },
            {
                "regulatorName": "FINRA",
                "registrationStatusCode": "PURGED",
                "registrationCategoryName": "Research Analyst",
                "registrationCategoryCode": "RS",
                "registrationStatusName": "Purged",
                "regulatorCode": "FINRA",
                "firmCrdNumber": 37909,
                "firmName": "KAUFMAN BROS., L.P.",
                "statusEffectiveDate": "2011-03-08"
            },
            {
                "regulatorName": "Nasdaq Stock Market",
                "registrationStatusCode": "APPROVED",
                "registrationCategoryName": "General Securities Representative",
                "registrationCategoryCode": "GS",
                "registrationStatusName": "Approved",
                "regulatorCode": "NQX",
                "firmCrdNumber": 37909,
                "firmName": "KAUFMAN BROS., L.P.",
                "statusEffectiveDate": "2011-07-26"
            },
            {
                "regulatorName": "FINRA",
                "registrationStatusCode": "DEFICIENT",
                "registrationCategoryName": "Research Analyst",
                "registrationCategoryCode": "RS",
                "registrationStatusName": "Deficient",
                "regulatorCode": "FINRA",
                "firmCrdNumber": 37909,
                "firmName": "KAUFMAN BROS., L.P.",
                "statusEffectiveDate": "2010-09-09"
            },
            {
                "regulatorName": "New York",
                "registrationStatusCode": "APPROVED",
                "registrationCategoryName": "Agent",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Approved",
                "regulatorCode": "NY",
                "firmCrdNumber": 37909,
                "firmName": "KAUFMAN BROS., L.P.",
                "statusEffectiveDate": "2010-09-08"
            },
            {
                "regulatorName": "FINRA",
                "registrationStatusCode": "APRSLTS",
                "registrationCategoryName": "General Securities Representative",
                "registrationCategoryCode": "GS",
                "registrationStatusName": "Approved Pending Results",
                "regulatorCode": "FINRA",
                "firmCrdNumber": 152234,
                "firmName": "WELBORN CAPITAL LLC",
                "statusEffectiveDate": "2013-07-09"
            },
            {
                "regulatorName": "FINRA",
                "registrationStatusCode": "APRSLTS",
                "registrationCategoryName": "Investment Banking Representative",
                "registrationCategoryCode": "IB",
                "registrationStatusName": "Approved Pending Results",
                "regulatorCode": "FINRA",
                "firmCrdNumber": 152234,
                "firmName": "WELBORN CAPITAL LLC",
                "statusEffectiveDate": "2013-07-09"
            },
            {
                "regulatorName": "New York",
                "registrationStatusCode": "PENDING",
                "registrationCategoryName": "Agent",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Pending",
                "regulatorCode": "NY",
                "firmCrdNumber": 152234,
                "firmName": "WELBORN CAPITAL LLC",
                "statusEffectiveDate": "2013-06-21"
            },
            {
                "regulatorName": "FINRA",
                "registrationStatusCode": "INACTIVE_PRINTS",
                "registrationCategoryName": "General Securities Representative",
                "registrationCategoryCode": "GS",
                "registrationStatusName": "Inactive - Prints",
                "regulatorCode": "FINRA",
                "firmCrdNumber": 152234,
                "firmName": "WELBORN CAPITAL LLC",
                "statusEffectiveDate": "2013-06-24"
            },
            {
                "regulatorName": "FINRA",
                "registrationStatusCode": "INACTIVE_PRINTS",
                "registrationCategoryName": "Investment Banking Representative",
                "registrationCategoryCode": "IB",
                "registrationStatusName": "Inactive - Prints",
                "regulatorCode": "FINRA",
                "firmCrdNumber": 152234,
                "firmName": "WELBORN CAPITAL LLC",
                "statusEffectiveDate": "2013-06-24"
            },
            {
                "regulatorName": "FINRA",
                "registrationStatusCode": "APPROVED",
                "registrationCategoryName": "General Securities Representative",
                "registrationCategoryCode": "GS",
                "registrationStatusName": "Approved",
                "regulatorCode": "FINRA",
                "firmCrdNumber": 152234,
                "firmName": "WELBORN CAPITAL LLC",
                "statusEffectiveDate": "2013-07-10"
            },
            {
                "regulatorName": "FINRA",
                "registrationStatusCode": "APPROVED",
                "registrationCategoryName": "Investment Banking Representative",
                "registrationCategoryCode": "IB",
                "registrationStatusName": "Approved",
                "regulatorCode": "FINRA",
                "firmCrdNumber": 152234,
                "firmName": "WELBORN CAPITAL LLC",
                "statusEffectiveDate": "2013-07-10"
            },
            {
                "regulatorName": "New York",
                "registrationStatusCode": "T_NOREG",
                "registrationCategoryName": "Agent",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Termed Without Registration",
                "regulatorCode": "NY",
                "firmCrdNumber": 152234,
                "firmName": "WELBORN CAPITAL LLC",
                "statusEffectiveDate": "2013-07-31"
            },
            {
                "regulatorName": "FINRA",
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "General Securities Representative",
                "registrationCategoryCode": "GS",
                "registrationStatusName": "Termed",
                "regulatorCode": "FINRA",
                "firmCrdNumber": 152234,
                "firmName": "WELBORN CAPITAL LLC",
                "statusEffectiveDate": "2013-07-31"
            },
            {
                "regulatorName": "FINRA",
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Investment Banking Representative",
                "registrationCategoryCode": "IB",
                "registrationStatusName": "Termed",
                "regulatorCode": "FINRA",
                "firmCrdNumber": 152234,
                "firmName": "WELBORN CAPITAL LLC",
                "statusEffectiveDate": "2013-07-31"
            },
            {
                "regulatorName": "FINRA",
                "registrationStatusCode": "T_NOREG",
                "registrationCategoryName": "Research Principal",
                "registrationCategoryCode": "RP",
                "registrationStatusName": "Termed Without Registration",
                "regulatorCode": "FINRA",
                "firmCrdNumber": 152234,
                "firmName": "WELBORN CAPITAL LLC",
                "statusEffectiveDate": "2013-07-31"
            },
            {
                "regulatorName": "FINRA",
                "registrationStatusCode": "APRSLTS",
                "registrationCategoryName": "General Securities Representative",
                "registrationCategoryCode": "GS",
                "registrationStatusName": "Approved Pending Results",
                "regulatorCode": "FINRA",
                "firmCrdNumber": 79,
                "firmName": "J.P. MORGAN SECURITIES LLC",
                "statusEffectiveDate": "2015-04-27"
            },
            {
                "regulatorName": "Nasdaq BX, Inc.",
                "registrationStatusCode": "APRSLTS",
                "registrationCategoryName": "General Securities Representative",
                "registrationCategoryCode": "GS",
                "registrationStatusName": "Approved Pending Results",
                "regulatorCode": "BX",
                "firmCrdNumber": 79,
                "firmName": "J.P. MORGAN SECURITIES LLC",
                "statusEffectiveDate": "2015-04-27"
            },
            {
                "regulatorName": "Nasdaq PHLX LLC",
                "registrationStatusCode": "APRSLTS",
                "registrationCategoryName": "General Securities Representative",
                "registrationCategoryCode": "GS",
                "registrationStatusName": "Approved Pending Results",
                "regulatorCode": "PHLX",
                "firmCrdNumber": 79,
                "firmName": "J.P. MORGAN SECURITIES LLC",
                "statusEffectiveDate": "2015-04-27"
            },
            {
                "regulatorName": "Nasdaq Stock Market",
                "registrationStatusCode": "APRSLTS",
                "registrationCategoryName": "General Securities Representative",
                "registrationCategoryCode": "GS",
                "registrationStatusName": "Approved Pending Results",
                "regulatorCode": "NQX",
                "firmCrdNumber": 79,
                "firmName": "J.P. MORGAN SECURITIES LLC",
                "statusEffectiveDate": "2015-04-27"
            },
            {
                "regulatorName": "BOX Exchange LLC",
                "registrationStatusCode": "APRSLTS",
                "registrationCategoryName": "General Securities Representative",
                "registrationCategoryCode": "GS",
                "registrationStatusName": "Approved Pending Results",
                "regulatorCode": "BOX",
                "firmCrdNumber": 79,
                "firmName": "J.P. MORGAN SECURITIES LLC",
                "statusEffectiveDate": "2015-04-27"
            },
            {
                "regulatorName": "FINRA",
                "registrationStatusCode": "APPROVED",
                "registrationCategoryName": "General Securities Representative",
                "registrationCategoryCode": "GS",
                "registrationStatusName": "Approved",
                "regulatorCode": "FINRA",
                "firmCrdNumber": 79,
                "firmName": "J.P. MORGAN SECURITIES LLC",
                "statusEffectiveDate": "2015-04-27"
            },
            {
                "regulatorName": "Nasdaq BX, Inc.",
                "registrationStatusCode": "APPROVED",
                "registrationCategoryName": "General Securities Representative",
                "registrationCategoryCode": "GS",
                "registrationStatusName": "Approved",
                "regulatorCode": "BX",
                "firmCrdNumber": 79,
                "firmName": "J.P. MORGAN SECURITIES LLC",
                "statusEffectiveDate": "2015-04-27"
            },
            {
                "regulatorName": "Nasdaq PHLX LLC",
                "registrationStatusCode": "APPROVED",
                "registrationCategoryName": "General Securities Representative",
                "registrationCategoryCode": "GS",
                "registrationStatusName": "Approved",
                "regulatorCode": "PHLX",
                "firmCrdNumber": 79,
                "firmName": "J.P. MORGAN SECURITIES LLC",
                "statusEffectiveDate": "2015-04-27"
            },
            {
                "regulatorName": "Nasdaq Stock Market",
                "registrationStatusCode": "APPROVED",
                "registrationCategoryName": "General Securities Representative",
                "registrationCategoryCode": "GS",
                "registrationStatusName": "Approved",
                "regulatorCode": "NQX",
                "firmCrdNumber": 79,
                "firmName": "J.P. MORGAN SECURITIES LLC",
                "statusEffectiveDate": "2015-04-27"
            },
            {
                "regulatorName": "BOX Exchange LLC",
                "registrationStatusCode": "APPROVED",
                "registrationCategoryName": "General Securities Representative",
                "registrationCategoryCode": "GS",
                "registrationStatusName": "Approved",
                "regulatorCode": "BOX",
                "firmCrdNumber": 79,
                "firmName": "J.P. MORGAN SECURITIES LLC",
                "statusEffectiveDate": "2015-04-27"
            },
            {
                "regulatorName": "FINRA",
                "registrationStatusCode": "APPRNT",
                "registrationCategoryName": "General Securities Representative",
                "registrationCategoryCode": "GS",
                "registrationStatusName": "Approved Pending Prints",
                "regulatorCode": "FINRA",
                "firmCrdNumber": 152234,
                "firmName": "WELBORN CAPITAL LLC",
                "statusEffectiveDate": "2013-06-21"
            },
            {
                "regulatorName": "FINRA",
                "registrationStatusCode": "APPRNT",
                "registrationCategoryName": "Investment Banking Representative",
                "registrationCategoryCode": "IB",
                "registrationStatusName": "Approved Pending Prints",
                "regulatorCode": "FINRA",
                "firmCrdNumber": 152234,
                "firmName": "WELBORN CAPITAL LLC",
                "statusEffectiveDate": "2013-06-21"
            },
            {
                "regulatorName": "NYSE National, Inc.",
                "registrationStatusCode": "APPROVED",
                "registrationCategoryName": "General Securities Representative",
                "registrationCategoryCode": "GS",
                "registrationStatusName": "Approved",
                "regulatorCode": "NYSE-NAT",
                "firmCrdNumber": 79,
                "firmName": "J.P. MORGAN SECURITIES LLC",
                "statusEffectiveDate": "2016-04-14"
            },
            {
                "regulatorName": "Nasdaq BX, Inc.",
                "registrationStatusCode": "APPRNT",
                "registrationCategoryName": "General Securities Representative",
                "registrationCategoryCode": "GS",
                "registrationStatusName": "Approved Pending Prints",
                "regulatorCode": "BX",
                "firmCrdNumber": 79,
                "firmName": "J.P. MORGAN SECURITIES LLC",
                "statusEffectiveDate": "2015-04-23"
            },
            {
                "regulatorName": "FINRA",
                "registrationStatusCode": "APPRNT",
                "registrationCategoryName": "General Securities Representative",
                "registrationCategoryCode": "GS",
                "registrationStatusName": "Approved Pending Prints",
                "regulatorCode": "FINRA",
                "firmCrdNumber": 79,
                "firmName": "J.P. MORGAN SECURITIES LLC",
                "statusEffectiveDate": "2015-04-23"
            },
            {
                "regulatorName": "BOX Exchange LLC",
                "registrationStatusCode": "APPRNT",
                "registrationCategoryName": "General Securities Representative",
                "registrationCategoryCode": "GS",
                "registrationStatusName": "Approved Pending Prints",
                "regulatorCode": "BOX",
                "firmCrdNumber": 79,
                "firmName": "J.P. MORGAN SECURITIES LLC",
                "statusEffectiveDate": "2015-04-23"
            },
            {
                "regulatorName": "Nasdaq Stock Market",
                "registrationStatusCode": "APPRNT",
                "registrationCategoryName": "General Securities Representative",
                "registrationCategoryCode": "GS",
                "registrationStatusName": "Approved Pending Prints",
                "regulatorCode": "NQX",
                "firmCrdNumber": 79,
                "firmName": "J.P. MORGAN SECURITIES LLC",
                "statusEffectiveDate": "2015-04-23"
            },
            {
                "regulatorName": "Nasdaq PHLX LLC",
                "registrationStatusCode": "APPRNT",
                "registrationCategoryName": "General Securities Representative",
                "registrationCategoryCode": "GS",
                "registrationStatusName": "Approved Pending Prints",
                "regulatorCode": "PHLX",
                "firmCrdNumber": 79,
                "firmName": "J.P. MORGAN SECURITIES LLC",
                "statusEffectiveDate": "2015-04-23"
            },
            {
                "regulatorName": "Investors' Exchange LLC",
                "registrationStatusCode": "APPROVED",
                "registrationCategoryName": "General Securities Representative",
                "registrationCategoryCode": "GS",
                "registrationStatusName": "Approved",
                "regulatorCode": "IEX",
                "firmCrdNumber": 79,
                "firmName": "J.P. MORGAN SECURITIES LLC",
                "statusEffectiveDate": "2016-08-30"
            },
            {
                "regulatorName": "NYSE National, Inc.",
                "registrationStatusCode": "T_NOU5",
                "registrationCategoryName": "General Securities Representative",
                "registrationCategoryCode": "GS",
                "registrationStatusName": "Terminated Without U5",
                "regulatorCode": "NYSE-NAT",
                "firmCrdNumber": 79,
                "firmName": "J.P. MORGAN SECURITIES LLC",
                "statusEffectiveDate": "2017-02-01"
            },
            {
                "regulatorName": "BOX Exchange LLC",
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "General Securities Representative",
                "registrationCategoryCode": "GS",
                "registrationStatusName": "Termed",
                "regulatorCode": "BOX",
                "firmCrdNumber": 79,
                "firmName": "J.P. MORGAN SECURITIES LLC",
                "statusEffectiveDate": "2018-04-25"
            },
            {
                "regulatorName": "Nasdaq BX, Inc.",
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "General Securities Representative",
                "registrationCategoryCode": "GS",
                "registrationStatusName": "Termed",
                "regulatorCode": "BX",
                "firmCrdNumber": 79,
                "firmName": "J.P. MORGAN SECURITIES LLC",
                "statusEffectiveDate": "2018-04-25"
            },
            {
                "regulatorName": "Nasdaq Stock Market",
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "General Securities Representative",
                "registrationCategoryCode": "GS",
                "registrationStatusName": "Termed",
                "regulatorCode": "NQX",
                "firmCrdNumber": 79,
                "firmName": "J.P. MORGAN SECURITIES LLC",
                "statusEffectiveDate": "2018-04-25"
            },
            {
                "regulatorName": "Nasdaq PHLX LLC",
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "General Securities Representative",
                "registrationCategoryCode": "GS",
                "registrationStatusName": "Termed",
                "regulatorCode": "PHLX",
                "firmCrdNumber": 79,
                "firmName": "J.P. MORGAN SECURITIES LLC",
                "statusEffectiveDate": "2018-04-25"
            },
            {
                "regulatorName": "FINRA",
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "General Securities Representative",
                "registrationCategoryCode": "GS",
                "registrationStatusName": "Termed",
                "regulatorCode": "FINRA",
                "firmCrdNumber": 79,
                "firmName": "J.P. MORGAN SECURITIES LLC",
                "statusEffectiveDate": "2018-04-25"
            },
            {
                "regulatorName": "Investors' Exchange LLC",
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "General Securities Representative",
                "registrationCategoryCode": "GS",
                "registrationStatusName": "Termed",
                "regulatorCode": "IEX",
                "firmCrdNumber": 79,
                "firmName": "J.P. MORGAN SECURITIES LLC",
                "statusEffectiveDate": "2018-04-25"
            }
        ],
        "individualCrdNumber": 1000005
    },
    {
        "registrationStatusHistory": [
            {
                "regulatorName": "FINRA",
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Foreign Currency Options Representative",
                "registrationCategoryCode": "FC",
                "registrationStatusName": "Termed",
                "regulatorCode": "FINRA",
                "firmCrdNumber": 361,
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "statusEffectiveDate": "1998-01-01"
            },
            {
                "regulatorName": "FINRA",
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "General Securities Representative",
                "registrationCategoryCode": "GS",
                "registrationStatusName": "Termed",
                "regulatorCode": "FINRA",
                "firmCrdNumber": 361,
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "statusEffectiveDate": "1998-01-01"
            },
            {
                "regulatorName": "FINRA",
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "General Securities Sales Supervisor",
                "registrationCategoryCode": "SU",
                "registrationStatusName": "Termed",
                "regulatorCode": "FINRA",
                "firmCrdNumber": 361,
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "statusEffectiveDate": "1998-01-01"
            },
            {
                "regulatorName": "NYSE American LLC",
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Branch Office Manager (NYSE)",
                "registrationCategoryCode": "BM",
                "registrationStatusName": "Termed",
                "regulatorCode": "NYSE-AMER",
                "firmCrdNumber": 361,
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "statusEffectiveDate": "1998-01-01"
            },
            {
                "regulatorName": "NYSE American LLC",
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "General Securities Representative",
                "registrationCategoryCode": "GS",
                "registrationStatusName": "Termed",
                "regulatorCode": "NYSE-AMER",
                "firmCrdNumber": 361,
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "statusEffectiveDate": "1998-01-01"
            },
            {
                "regulatorName": "Cboe Exchange, Inc.",
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "General Securities Representative",
                "registrationCategoryCode": "GS",
                "registrationStatusName": "Termed",
                "regulatorCode": "CBOE",
                "firmCrdNumber": 361,
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "statusEffectiveDate": "1998-01-01"
            },
            {
                "regulatorName": "Cboe Exchange, Inc.",
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "General Securities Sales Supervisor",
                "registrationCategoryCode": "SU",
                "registrationStatusName": "Termed",
                "regulatorCode": "CBOE",
                "firmCrdNumber": 361,
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "statusEffectiveDate": "1998-01-01"
            },
            {
                "regulatorName": "New York Stock Exchange",
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Branch Office Manager (NYSE)",
                "registrationCategoryCode": "BM",
                "registrationStatusName": "Termed",
                "regulatorCode": "NYSE",
                "firmCrdNumber": 361,
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "statusEffectiveDate": "1998-01-01"
            },
            {
                "regulatorName": "New York Stock Exchange",
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "General Securities Representative",
                "registrationCategoryCode": "GS",
                "registrationStatusName": "Termed",
                "regulatorCode": "NYSE",
                "firmCrdNumber": 361,
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "statusEffectiveDate": "1998-01-01"
            },
            {
                "regulatorName": "Nasdaq PHLX LLC",
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "General Securities Representative",
                "registrationCategoryCode": "GS",
                "registrationStatusName": "Termed",
                "regulatorCode": "PHLX",
                "firmCrdNumber": 361,
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "statusEffectiveDate": "1998-01-01"
            },
            {
                "regulatorName": "Nasdaq PHLX LLC",
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "General Securities Sales Supervisor",
                "registrationCategoryCode": "SU",
                "registrationStatusName": "Termed",
                "regulatorCode": "PHLX",
                "firmCrdNumber": 361,
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "statusEffectiveDate": "1998-01-01"
            },
            {
                "regulatorName": "NYSE Arca, Inc.",
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "General Securities Representative",
                "registrationCategoryCode": "GS",
                "registrationStatusName": "Termed",
                "regulatorCode": "NYSE-ARCA",
                "firmCrdNumber": 361,
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "statusEffectiveDate": "1998-01-01"
            },
            {
                "regulatorName": "NYSE Arca, Inc.",
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "General Securities Sales Supervisor",
                "registrationCategoryCode": "SU",
                "registrationStatusName": "Termed",
                "regulatorCode": "NYSE-ARCA",
                "firmCrdNumber": 361,
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "statusEffectiveDate": "1998-01-01"
            },
            {
                "regulatorName": "Alaska",
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Agent",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Termed",
                "regulatorCode": "AK",
                "firmCrdNumber": 361,
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "statusEffectiveDate": "1998-01-01"
            },
            {
                "regulatorName": "Arizona",
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Agent",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Termed",
                "regulatorCode": "AZ",
                "firmCrdNumber": 361,
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "statusEffectiveDate": "1998-01-01"
            },
            {
                "regulatorName": "California",
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Agent",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Termed",
                "regulatorCode": "CA",
                "firmCrdNumber": 361,
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "statusEffectiveDate": "1998-01-01"
            },
            {
                "regulatorName": "Colorado",
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Agent",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Termed",
                "regulatorCode": "CO",
                "firmCrdNumber": 361,
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "statusEffectiveDate": "1998-01-01"
            },
            {
                "regulatorName": "Hawaii",
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Agent",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Termed",
                "regulatorCode": "HI",
                "firmCrdNumber": 361,
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "statusEffectiveDate": "1998-01-01"
            },
            {
                "regulatorName": "Idaho",
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Agent",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Termed",
                "regulatorCode": "ID",
                "firmCrdNumber": 361,
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "statusEffectiveDate": "1998-01-01"
            },
            {
                "regulatorName": "Illinois",
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Agent",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Termed",
                "regulatorCode": "IL",
                "firmCrdNumber": 361,
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "statusEffectiveDate": "1998-01-01"
            },
            {
                "regulatorName": "Massachusetts",
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Agent",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Termed",
                "regulatorCode": "MA",
                "firmCrdNumber": 361,
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "statusEffectiveDate": "1998-01-01"
            },
            {
                "regulatorName": "Nevada",
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Agent",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Termed",
                "regulatorCode": "NV",
                "firmCrdNumber": 361,
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "statusEffectiveDate": "1998-01-01"
            },
            {
                "regulatorName": "New Jersey",
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Agent",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Termed",
                "regulatorCode": "NJ",
                "firmCrdNumber": 361,
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "statusEffectiveDate": "1998-01-01"
            },
            {
                "regulatorName": "New Mexico",
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Agent",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Termed",
                "regulatorCode": "NM",
                "firmCrdNumber": 361,
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "statusEffectiveDate": "1998-01-01"
            },
            {
                "regulatorName": "New York",
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Agent",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Termed",
                "regulatorCode": "NY",
                "firmCrdNumber": 361,
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "statusEffectiveDate": "1998-01-01"
            },
            {
                "regulatorName": "Oklahoma",
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Agent",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Termed",
                "regulatorCode": "OK",
                "firmCrdNumber": 361,
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "statusEffectiveDate": "1998-01-01"
            },
            {
                "regulatorName": "Oregon",
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Agent",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Termed",
                "regulatorCode": "OR",
                "firmCrdNumber": 361,
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "statusEffectiveDate": "1998-01-01"
            },
            {
                "regulatorName": "Utah",
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Agent",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Termed",
                "regulatorCode": "UT",
                "firmCrdNumber": 361,
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "statusEffectiveDate": "1998-01-01"
            },
            {
                "regulatorName": "Washington",
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Agent",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Termed",
                "regulatorCode": "WA",
                "firmCrdNumber": 361,
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "statusEffectiveDate": "1998-01-01"
            },
            {
                "regulatorName": "Wyoming",
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Agent",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Termed",
                "regulatorCode": "WY",
                "firmCrdNumber": 361,
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "statusEffectiveDate": "1998-01-01"
            },
            {
                "regulatorName": "FINRA",
                "registrationStatusCode": "DEFICIENT",
                "registrationCategoryName": "General Securities Representative",
                "registrationCategoryCode": "GS",
                "registrationStatusName": "Deficient",
                "regulatorCode": "FINRA",
                "firmCrdNumber": 153822,
                "firmName": "CLEARWATER SECURITIES, LLC",
                "statusEffectiveDate": "2010-06-08"
            },
            {
                "regulatorName": "California",
                "registrationStatusCode": "DEFICIENT",
                "registrationCategoryName": "Agent",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Deficient",
                "regulatorCode": "CA",
                "firmCrdNumber": 153822,
                "firmName": "CLEARWATER SECURITIES, LLC",
                "statusEffectiveDate": "2010-06-08"
            },
            {
                "regulatorName": "Idaho",
                "registrationStatusCode": "DEFICIENT",
                "registrationCategoryName": "Agent",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Deficient",
                "regulatorCode": "ID",
                "firmCrdNumber": 153822,
                "firmName": "CLEARWATER SECURITIES, LLC",
                "statusEffectiveDate": "2010-06-08"
            },
            {
                "regulatorName": "Idaho",
                "registrationStatusCode": "DEFICIENT",
                "registrationCategoryName": "Investment Advisor Representative",
                "registrationCategoryCode": "RA",
                "registrationStatusName": "Deficient",
                "regulatorCode": "ID",
                "firmCrdNumber": 109394,
                "firmName": null,
                "statusEffectiveDate": "2006-03-10"
            },
            {
                "regulatorName": "Idaho",
                "registrationStatusCode": "DEFICIENT",
                "registrationCategoryName": "Investment Advisor Representative",
                "registrationCategoryCode": "RA",
                "registrationStatusName": "Deficient",
                "regulatorCode": "ID",
                "firmCrdNumber": 116865,
                "firmName": "CLEARWATER ADVISORS, LLC",
                "statusEffectiveDate": "2006-03-10"
            },
            {
                "regulatorName": "Idaho",
                "registrationStatusCode": "APPROVED",
                "registrationCategoryName": "Investment Advisor Representative",
                "registrationCategoryCode": "RA",
                "registrationStatusName": "Approved",
                "regulatorCode": "ID",
                "firmCrdNumber": 116865,
                "firmName": "CLEARWATER ADVISORS, LLC",
                "statusEffectiveDate": "2006-03-10"
            },
            {
                "regulatorName": "Idaho",
                "registrationStatusCode": "APPROVED",
                "registrationCategoryName": "Investment Advisor Representative",
                "registrationCategoryCode": "RA",
                "registrationStatusName": "Approved",
                "regulatorCode": "ID",
                "firmCrdNumber": 109394,
                "firmName": null,
                "statusEffectiveDate": "2006-03-10"
            },
            {
                "regulatorName": "California",
                "registrationStatusCode": "T_NOREG",
                "registrationCategoryName": "Agent",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Termed Without Registration",
                "regulatorCode": "CA",
                "firmCrdNumber": 153822,
                "firmName": "CLEARWATER SECURITIES, LLC",
                "statusEffectiveDate": "2011-04-29"
            },
            {
                "regulatorName": "Idaho",
                "registrationStatusCode": "T_NOREG",
                "registrationCategoryName": "Agent",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Termed Without Registration",
                "regulatorCode": "ID",
                "firmCrdNumber": 153822,
                "firmName": "CLEARWATER SECURITIES, LLC",
                "statusEffectiveDate": "2013-02-22"
            },
            {
                "regulatorName": "Idaho",
                "registrationStatusCode": "PENDING",
                "registrationCategoryName": "Agent",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Pending",
                "regulatorCode": "ID",
                "firmCrdNumber": 153822,
                "firmName": "CLEARWATER SECURITIES, LLC",
                "statusEffectiveDate": "2010-06-08"
            },
            {
                "regulatorName": "Idaho",
                "registrationStatusCode": "APPROVED",
                "registrationCategoryName": "Agent",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Approved",
                "regulatorCode": "ID",
                "firmCrdNumber": 153822,
                "firmName": "CLEARWATER SECURITIES, LLC",
                "statusEffectiveDate": "2010-10-28"
            },
            {
                "regulatorName": "Idaho",
                "registrationStatusCode": "T_NOU5",
                "registrationCategoryName": "Investment Advisor Representative",
                "registrationCategoryCode": "RA",
                "registrationStatusName": "Terminated Without U5",
                "regulatorCode": "ID",
                "firmCrdNumber": 109394,
                "firmName": null,
                "statusEffectiveDate": "2010-04-14"
            },
            {
                "regulatorName": "FINRA",
                "registrationStatusCode": "T_NOREG",
                "registrationCategoryName": "General Securities Representative",
                "registrationCategoryCode": "GS",
                "registrationStatusName": "Termed Without Registration",
                "regulatorCode": "FINRA",
                "firmCrdNumber": 153822,
                "firmName": "CLEARWATER SECURITIES, LLC",
                "statusEffectiveDate": "2013-03-07"
            },
            {
                "regulatorName": "Idaho",
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Investment Advisor Representative",
                "registrationCategoryCode": "RA",
                "registrationStatusName": "Termed",
                "regulatorCode": "ID",
                "firmCrdNumber": 116865,
                "firmName": "CLEARWATER ADVISORS, LLC",
                "statusEffectiveDate": "2022-01-12"
            }
        ],
        "individualCrdNumber": 1000018
    }
]

 

Sample Request
https://api.finra.org/data/group/firm/name/inactiveIndividualRegistrationStatusHistoryMock

 

Sample Request Payload
{
"limit":2,
"fields":["individualCrdNumber","registrationStatusHistory.regulatorCode","registrationStatusHistory.registrationStatusCode"]
}
 

 

Sample Response
[
    {
        "registrationStatusHistory": [
            {
                "registrationStatusCode": "DEFICIENT",
                "regulatorCode": "FINRA"
            },
            {
                "registrationStatusCode": "DEFICIENT",
                "regulatorCode": "NY"
            },
            {
                "registrationStatusCode": "APPRNT",
                "regulatorCode": "FINRA"
            },
            {
                "registrationStatusCode": "APRSLTS",
                "regulatorCode": "FINRA"
            },
            {
                "registrationStatusCode": "APPROVED",
                "regulatorCode": "FINRA"
            },
            {
                "registrationStatusCode": "DEFICIENT",
                "regulatorCode": "FINRA"
            },
            {
                "registrationStatusCode": "T_NOREG",
                "regulatorCode": "FINRA"
            },
            {
                "registrationStatusCode": "TERMED",
                "regulatorCode": "FINRA"
            },
            {
                "registrationStatusCode": "TERMED",
                "regulatorCode": "NQX"
            },
            {
                "registrationStatusCode": "TERMED",
                "regulatorCode": "FINRA"
            },
            {
                "registrationStatusCode": "TERMED",
                "regulatorCode": "NY"
            },
            {
                "registrationStatusCode": "DEFICIENT",
                "regulatorCode": "FINRA"
            },
            {
                "registrationStatusCode": "DEFICIENT",
                "regulatorCode": "FINRA"
            },
            {
                "registrationStatusCode": "DEFICIENT",
                "regulatorCode": "FINRA"
            },
            {
                "registrationStatusCode": "DEFICIENT",
                "regulatorCode": "NY"
            },
            {
                "registrationStatusCode": "APPROVED",
                "regulatorCode": "FINRA"
            },
            {
                "registrationStatusCode": "PURGED",
                "regulatorCode": "FINRA"
            },
            {
                "registrationStatusCode": "APPROVED",
                "regulatorCode": "NQX"
            },
            {
                "registrationStatusCode": "DEFICIENT",
                "regulatorCode": "FINRA"
            },
            {
                "registrationStatusCode": "APPROVED",
                "regulatorCode": "NY"
            },
            {
                "registrationStatusCode": "APRSLTS",
                "regulatorCode": "FINRA"
            },
            {
                "registrationStatusCode": "APRSLTS",
                "regulatorCode": "FINRA"
            },
            {
                "registrationStatusCode": "PENDING",
                "regulatorCode": "NY"
            },
            {
                "registrationStatusCode": "INACTIVE_PRINTS",
                "regulatorCode": "FINRA"
            },
            {
                "registrationStatusCode": "INACTIVE_PRINTS",
                "regulatorCode": "FINRA"
            },
            {
                "registrationStatusCode": "APPROVED",
                "regulatorCode": "FINRA"
            },
            {
                "registrationStatusCode": "APPROVED",
                "regulatorCode": "FINRA"
            },
            {
                "registrationStatusCode": "T_NOREG",
                "regulatorCode": "NY"
            },
            {
                "registrationStatusCode": "TERMED",
                "regulatorCode": "FINRA"
            },
            {
                "registrationStatusCode": "TERMED",
                "regulatorCode": "FINRA"
            },
            {
                "registrationStatusCode": "T_NOREG",
                "regulatorCode": "FINRA"
            },
            {
                "registrationStatusCode": "APRSLTS",
                "regulatorCode": "FINRA"
            },
            {
                "registrationStatusCode": "APRSLTS",
                "regulatorCode": "BX"
            },
            {
                "registrationStatusCode": "APRSLTS",
                "regulatorCode": "PHLX"
            },
            {
                "registrationStatusCode": "APRSLTS",
                "regulatorCode": "NQX"
            },
            {
                "registrationStatusCode": "APRSLTS",
                "regulatorCode": "BOX"
            },
            {
                "registrationStatusCode": "APPROVED",
                "regulatorCode": "FINRA"
            },
            {
                "registrationStatusCode": "APPROVED",
                "regulatorCode": "BX"
            },
            {
                "registrationStatusCode": "APPROVED",
                "regulatorCode": "PHLX"
            },
            {
                "registrationStatusCode": "APPROVED",
                "regulatorCode": "NQX"
            },
            {
                "registrationStatusCode": "APPROVED",
                "regulatorCode": "BOX"
            },
            {
                "registrationStatusCode": "APPRNT",
                "regulatorCode": "FINRA"
            },
            {
                "registrationStatusCode": "APPRNT",
                "regulatorCode": "FINRA"
            },
            {
                "registrationStatusCode": "APPROVED",
                "regulatorCode": "NYSE-NAT"
            },
            {
                "registrationStatusCode": "APPRNT",
                "regulatorCode": "BX"
            },
            {
                "registrationStatusCode": "APPRNT",
                "regulatorCode": "FINRA"
            },
            {
                "registrationStatusCode": "APPRNT",
                "regulatorCode": "BOX"
            },
            {
                "registrationStatusCode": "APPRNT",
                "regulatorCode": "NQX"
            },
            {
                "registrationStatusCode": "APPRNT",
                "regulatorCode": "PHLX"
            },
            {
                "registrationStatusCode": "APPROVED",
                "regulatorCode": "IEX"
            },
            {
                "registrationStatusCode": "T_NOU5",
                "regulatorCode": "NYSE-NAT"
            },
            {
                "registrationStatusCode": "TERMED",
                "regulatorCode": "BOX"
            },
            {
                "registrationStatusCode": "TERMED",
                "regulatorCode": "BX"
            },
            {
                "registrationStatusCode": "TERMED",
                "regulatorCode": "NQX"
            },
            {
                "registrationStatusCode": "TERMED",
                "regulatorCode": "PHLX"
            },
            {
                "registrationStatusCode": "TERMED",
                "regulatorCode": "FINRA"
            },
            {
                "registrationStatusCode": "TERMED",
                "regulatorCode": "IEX"
            }
        ],
        "individualCrdNumber": 1000005
    },
    {
        "registrationStatusHistory": [
            {
                "registrationStatusCode": "TERMED",
                "regulatorCode": "FINRA"
            },
            {
                "registrationStatusCode": "TERMED",
                "regulatorCode": "FINRA"
            },
            {
                "registrationStatusCode": "TERMED",
                "regulatorCode": "FINRA"
            },
            {
                "registrationStatusCode": "TERMED",
                "regulatorCode": "NYSE-AMER"
            },
            {
                "registrationStatusCode": "TERMED",
                "regulatorCode": "NYSE-AMER"
            },
            {
                "registrationStatusCode": "TERMED",
                "regulatorCode": "CBOE"
            },
            {
                "registrationStatusCode": "TERMED",
                "regulatorCode": "CBOE"
            },
            {
                "registrationStatusCode": "TERMED",
                "regulatorCode": "NYSE"
            },
            {
                "registrationStatusCode": "TERMED",
                "regulatorCode": "NYSE"
            },
            {
                "registrationStatusCode": "TERMED",
                "regulatorCode": "PHLX"
            },
            {
                "registrationStatusCode": "TERMED",
                "regulatorCode": "PHLX"
            },
            {
                "registrationStatusCode": "TERMED",
                "regulatorCode": "NYSE-ARCA"
            },
            {
                "registrationStatusCode": "TERMED",
                "regulatorCode": "NYSE-ARCA"
            },
            {
                "registrationStatusCode": "TERMED",
                "regulatorCode": "AK"
            },
            {
                "registrationStatusCode": "TERMED",
                "regulatorCode": "AZ"
            },
            {
                "registrationStatusCode": "TERMED",
                "regulatorCode": "CA"
            },
            {
                "registrationStatusCode": "TERMED",
                "regulatorCode": "CO"
            },
            {
                "registrationStatusCode": "TERMED",
                "regulatorCode": "HI"
            },
            {
                "registrationStatusCode": "TERMED",
                "regulatorCode": "ID"
            },
            {
                "registrationStatusCode": "TERMED",
                "regulatorCode": "IL"
            },
            {
                "registrationStatusCode": "TERMED",
                "regulatorCode": "MA"
            },
            {
                "registrationStatusCode": "TERMED",
                "regulatorCode": "NV"
            },
            {
                "registrationStatusCode": "TERMED",
                "regulatorCode": "NJ"
            },
            {
                "registrationStatusCode": "TERMED",
                "regulatorCode": "NM"
            },
            {
                "registrationStatusCode": "TERMED",
                "regulatorCode": "NY"
            },
            {
                "registrationStatusCode": "TERMED",
                "regulatorCode": "OK"
            },
            {
                "registrationStatusCode": "TERMED",
                "regulatorCode": "OR"
            },
            {
                "registrationStatusCode": "TERMED",
                "regulatorCode": "UT"
            },
            {
                "registrationStatusCode": "TERMED",
                "regulatorCode": "WA"
            },
            {
                "registrationStatusCode": "TERMED",
                "regulatorCode": "WY"
            },
            {
                "registrationStatusCode": "DEFICIENT",
                "regulatorCode": "FINRA"
            },
            {
                "registrationStatusCode": "DEFICIENT",
                "regulatorCode": "CA"
            },
            {
                "registrationStatusCode": "DEFICIENT",
                "regulatorCode": "ID"
            },
            {
                "registrationStatusCode": "DEFICIENT",
                "regulatorCode": "ID"
            },
            {
                "registrationStatusCode": "DEFICIENT",
                "regulatorCode": "ID"
            },
            {
                "registrationStatusCode": "APPROVED",
                "regulatorCode": "ID"
            },
            {
                "registrationStatusCode": "APPROVED",
                "regulatorCode": "ID"
            },
            {
                "registrationStatusCode": "T_NOREG",
                "regulatorCode": "CA"
            },
            {
                "registrationStatusCode": "T_NOREG",
                "regulatorCode": "ID"
            },
            {
                "registrationStatusCode": "PENDING",
                "regulatorCode": "ID"
            },
            {
                "registrationStatusCode": "APPROVED",
                "regulatorCode": "ID"
            },
            {
                "registrationStatusCode": "T_NOU5",
                "regulatorCode": "ID"
            },
            {
                "registrationStatusCode": "T_NOREG",
                "regulatorCode": "FINRA"
            },
            {
                "registrationStatusCode": "TERMED",
                "regulatorCode": "ID"
            }
        ],
        "individualCrdNumber": 1000018
    }
]

 

Inactive Individual Registrations

Registration information for all indivdiuals formely employed by a firm.

Dataset Info:

group dataset test dataset
firm inactiveIndividualRegistrations inactiveIndividualRegistrationsMock

 

Sample Request
https://api.finra.org/data/group/firm/name/inactiveIndividualRegistrationsMock?limit=2

 

Sample Response
[
    {
        "registrations": [
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "General Securities Representative",
                "filingDate": "2015-04-23",
                "registrationCategoryCode": "GS",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 79,
                "regulatorName": "FINRA",
                "registrationBeginDate": "2015-04-23",
                "registrationEndDate": "2018-04-25",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "2018-04-25",
                "regulatorCode": "FINRA",
                "firmName": "J.P. MORGAN SECURITIES LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "General Securities Representative",
                "filingDate": "2015-04-23",
                "registrationCategoryCode": "GS",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 79,
                "regulatorName": "Nasdaq BX, Inc.",
                "registrationBeginDate": "2015-04-23",
                "registrationEndDate": "2018-04-25",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "2018-04-25",
                "regulatorCode": "BX",
                "firmName": "J.P. MORGAN SECURITIES LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "T_NOU5",
                "registrationCategoryName": "General Securities Representative",
                "filingDate": "2016-04-14",
                "registrationCategoryCode": "GS",
                "registrationStatusName": "Terminated Without U5",
                "firmCrdNumber": 79,
                "regulatorName": "NYSE National, Inc.",
                "registrationBeginDate": "2016-04-14",
                "registrationEndDate": "2017-02-01",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "2017-02-01",
                "regulatorCode": "NYSE-NAT",
                "firmName": "J.P. MORGAN SECURITIES LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "General Securities Representative",
                "filingDate": "2015-04-23",
                "registrationCategoryCode": "GS",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 79,
                "regulatorName": "Nasdaq PHLX LLC",
                "registrationBeginDate": "2015-04-23",
                "registrationEndDate": "2018-04-25",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "2018-04-25",
                "regulatorCode": "PHLX",
                "firmName": "J.P. MORGAN SECURITIES LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "General Securities Representative",
                "filingDate": "2015-04-23",
                "registrationCategoryCode": "GS",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 79,
                "regulatorName": "Nasdaq Stock Market",
                "registrationBeginDate": "2015-04-23",
                "registrationEndDate": "2018-04-25",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "2018-04-25",
                "regulatorCode": "NQX",
                "firmName": "J.P. MORGAN SECURITIES LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "General Securities Representative",
                "filingDate": "2015-04-23",
                "registrationCategoryCode": "GS",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 79,
                "regulatorName": "BOX Exchange LLC",
                "registrationBeginDate": "2015-04-23",
                "registrationEndDate": "2018-04-25",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "2018-04-25",
                "regulatorCode": "BOX",
                "firmName": "J.P. MORGAN SECURITIES LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "General Securities Representative",
                "filingDate": "2016-08-30",
                "registrationCategoryCode": "GS",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 79,
                "regulatorName": "Investors' Exchange LLC",
                "registrationBeginDate": "2016-08-30",
                "registrationEndDate": "2018-04-25",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "2018-04-25",
                "regulatorCode": "IEX",
                "firmName": "J.P. MORGAN SECURITIES LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Agent",
                "filingDate": "2010-06-22",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 37909,
                "regulatorName": "New York",
                "registrationBeginDate": "2010-09-08",
                "registrationEndDate": "2012-02-06",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "2012-02-06",
                "regulatorCode": "NY",
                "firmName": "KAUFMAN BROS., L.P.",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "General Securities Representative",
                "filingDate": "2010-07-13",
                "registrationCategoryCode": "GS",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 37909,
                "regulatorName": "FINRA",
                "registrationBeginDate": "2010-08-18",
                "registrationEndDate": "2012-02-06",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "2012-02-06",
                "regulatorCode": "FINRA",
                "firmName": "KAUFMAN BROS., L.P.",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "General Securities Representative",
                "filingDate": "2011-07-26",
                "registrationCategoryCode": "GS",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 37909,
                "regulatorName": "Nasdaq Stock Market",
                "registrationBeginDate": "2011-07-26",
                "registrationEndDate": "2012-02-06",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "2012-02-06",
                "regulatorCode": "NQX",
                "firmName": "KAUFMAN BROS., L.P.",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Investment Banking Representative",
                "filingDate": "2010-06-22",
                "registrationCategoryCode": "IB",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 37909,
                "regulatorName": "FINRA",
                "registrationBeginDate": "2010-06-30",
                "registrationEndDate": "2012-02-06",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "2012-02-06",
                "regulatorCode": "FINRA",
                "firmName": "KAUFMAN BROS., L.P.",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "T_NOREG",
                "registrationCategoryName": "Research Analyst",
                "filingDate": "2010-09-09",
                "registrationCategoryCode": "RS",
                "registrationStatusName": "Termed Without Registration",
                "firmCrdNumber": 37909,
                "regulatorName": "FINRA",
                "registrationBeginDate": null,
                "registrationEndDate": null,
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "2012-02-06",
                "regulatorCode": "FINRA",
                "firmName": "KAUFMAN BROS., L.P.",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "T_NOREG",
                "registrationCategoryName": "Agent",
                "filingDate": "2013-05-14",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Termed Without Registration",
                "firmCrdNumber": 152234,
                "regulatorName": "New York",
                "registrationBeginDate": null,
                "registrationEndDate": null,
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "2013-07-31",
                "regulatorCode": "NY",
                "firmName": "WELBORN CAPITAL LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "General Securities Representative",
                "filingDate": "2013-05-14",
                "registrationCategoryCode": "GS",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 152234,
                "regulatorName": "FINRA",
                "registrationBeginDate": "2013-06-21",
                "registrationEndDate": "2013-07-31",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "2013-07-31",
                "regulatorCode": "FINRA",
                "firmName": "WELBORN CAPITAL LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Investment Banking Representative",
                "filingDate": "2013-05-14",
                "registrationCategoryCode": "IB",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 152234,
                "regulatorName": "FINRA",
                "registrationBeginDate": "2013-06-21",
                "registrationEndDate": "2013-07-31",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "2013-07-31",
                "regulatorCode": "FINRA",
                "firmName": "WELBORN CAPITAL LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "T_NOREG",
                "registrationCategoryName": "Research Principal",
                "filingDate": "2013-05-14",
                "registrationCategoryCode": "RP",
                "registrationStatusName": "Termed Without Registration",
                "firmCrdNumber": 152234,
                "regulatorName": "FINRA",
                "registrationBeginDate": null,
                "registrationEndDate": null,
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "2013-07-31",
                "regulatorCode": "FINRA",
                "firmName": "WELBORN CAPITAL LLC",
                "isApproved": "NO"
            }
        ],
        "individualCrdNumber": 1000005
    },
    {
        "registrations": [
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Agent",
                "filingDate": "1999-07-05",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 361,
                "regulatorName": "Alaska",
                "registrationBeginDate": "1987-06-10",
                "registrationEndDate": "1998-01-01",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "1998-01-01",
                "regulatorCode": "AK",
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Agent",
                "filingDate": "1999-07-05",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 361,
                "regulatorName": "Arizona",
                "registrationBeginDate": "1987-06-12",
                "registrationEndDate": "1998-01-01",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "1998-01-01",
                "regulatorCode": "AZ",
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Agent",
                "filingDate": "1999-07-05",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 361,
                "regulatorName": "California",
                "registrationBeginDate": "1987-02-02",
                "registrationEndDate": "1998-01-01",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "1998-01-01",
                "regulatorCode": "CA",
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Agent",
                "filingDate": "1999-07-05",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 361,
                "regulatorName": "Colorado",
                "registrationBeginDate": "1987-02-02",
                "registrationEndDate": "1998-01-01",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "1998-01-01",
                "regulatorCode": "CO",
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Agent",
                "filingDate": "1999-07-05",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 361,
                "regulatorName": "Hawaii",
                "registrationBeginDate": "1988-03-02",
                "registrationEndDate": "1998-01-01",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "1998-01-01",
                "regulatorCode": "HI",
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Agent",
                "filingDate": "1999-07-05",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 361,
                "regulatorName": "Idaho",
                "registrationBeginDate": "1987-04-03",
                "registrationEndDate": "1998-01-01",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "1998-01-01",
                "regulatorCode": "ID",
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Agent",
                "filingDate": "1999-07-05",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 361,
                "regulatorName": "Illinois",
                "registrationBeginDate": "1993-12-22",
                "registrationEndDate": "1998-01-01",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "1998-01-01",
                "regulatorCode": "IL",
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Agent",
                "filingDate": "1999-07-05",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 361,
                "regulatorName": "Massachusetts",
                "registrationBeginDate": "1997-01-30",
                "registrationEndDate": "1998-01-01",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "1998-01-01",
                "regulatorCode": "MA",
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Agent",
                "filingDate": "1999-07-05",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 361,
                "regulatorName": "Nevada",
                "registrationBeginDate": "1987-06-10",
                "registrationEndDate": "1998-01-01",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "1998-01-01",
                "regulatorCode": "NV",
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Agent",
                "filingDate": "1999-07-05",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 361,
                "regulatorName": "New Jersey",
                "registrationBeginDate": "1995-11-21",
                "registrationEndDate": "1998-01-01",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "1998-01-01",
                "regulatorCode": "NJ",
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Agent",
                "filingDate": "1999-07-05",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 361,
                "regulatorName": "New Mexico",
                "registrationBeginDate": "1991-12-03",
                "registrationEndDate": "1998-01-01",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "1998-01-01",
                "regulatorCode": "NM",
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Agent",
                "filingDate": "1999-07-05",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 361,
                "regulatorName": "New York",
                "registrationBeginDate": "1989-06-14",
                "registrationEndDate": "1998-01-01",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "1998-01-01",
                "regulatorCode": "NY",
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Agent",
                "filingDate": "1999-07-05",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 361,
                "regulatorName": "Oklahoma",
                "registrationBeginDate": "1988-07-19",
                "registrationEndDate": "1998-01-01",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "1998-01-01",
                "regulatorCode": "OK",
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Agent",
                "filingDate": "1999-07-05",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 361,
                "regulatorName": "Oregon",
                "registrationBeginDate": "1987-02-02",
                "registrationEndDate": "1998-01-01",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "1998-01-01",
                "regulatorCode": "OR",
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Agent",
                "filingDate": "1999-07-05",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 361,
                "regulatorName": "Utah",
                "registrationBeginDate": "1987-06-11",
                "registrationEndDate": "1998-01-01",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "1998-01-01",
                "regulatorCode": "UT",
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Agent",
                "filingDate": "1999-07-05",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 361,
                "regulatorName": "Washington",
                "registrationBeginDate": "1987-06-11",
                "registrationEndDate": "1998-01-01",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "1998-01-01",
                "regulatorCode": "WA",
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Agent",
                "filingDate": "1999-07-05",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 361,
                "regulatorName": "Wyoming",
                "registrationBeginDate": "1987-06-11",
                "registrationEndDate": "1998-01-01",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "1998-01-01",
                "regulatorCode": "WY",
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Branch Office Manager (NYSE)",
                "filingDate": "1999-07-05",
                "registrationCategoryCode": "BM",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 361,
                "regulatorName": "NYSE American LLC",
                "registrationBeginDate": "1995-05-31",
                "registrationEndDate": "1998-01-01",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "1998-01-01",
                "regulatorCode": "NYSE-AMER",
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Branch Office Manager (NYSE)",
                "filingDate": "1999-07-05",
                "registrationCategoryCode": "BM",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 361,
                "regulatorName": "New York Stock Exchange",
                "registrationBeginDate": "1995-05-31",
                "registrationEndDate": "1998-01-01",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "1998-01-01",
                "regulatorCode": "NYSE",
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Foreign Currency Options Representative",
                "filingDate": "1999-07-05",
                "registrationCategoryCode": "FC",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 361,
                "regulatorName": "FINRA",
                "registrationBeginDate": "1983-11-25",
                "registrationEndDate": "1998-01-01",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "1998-01-01",
                "regulatorCode": "FINRA",
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "General Securities Representative",
                "filingDate": "1999-07-05",
                "registrationCategoryCode": "GS",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 361,
                "regulatorName": "FINRA",
                "registrationBeginDate": "1984-02-20",
                "registrationEndDate": "1998-01-01",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "1998-01-01",
                "regulatorCode": "FINRA",
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "General Securities Representative",
                "filingDate": "1999-07-05",
                "registrationCategoryCode": "GS",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 361,
                "regulatorName": "NYSE American LLC",
                "registrationBeginDate": "1988-04-03",
                "registrationEndDate": "1998-01-01",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "1998-01-01",
                "regulatorCode": "NYSE-AMER",
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "General Securities Representative",
                "filingDate": "1999-07-05",
                "registrationCategoryCode": "GS",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 361,
                "regulatorName": "Cboe Exchange, Inc.",
                "registrationBeginDate": "1991-03-03",
                "registrationEndDate": "1998-01-01",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "1998-01-01",
                "regulatorCode": "CBOE",
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "General Securities Representative",
                "filingDate": "1999-07-05",
                "registrationCategoryCode": "GS",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 361,
                "regulatorName": "New York Stock Exchange",
                "registrationBeginDate": "1984-09-14",
                "registrationEndDate": "1998-01-01",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "1998-01-01",
                "regulatorCode": "NYSE",
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "General Securities Representative",
                "filingDate": "1999-07-05",
                "registrationCategoryCode": "GS",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 361,
                "regulatorName": "Nasdaq PHLX LLC",
                "registrationBeginDate": "1993-10-16",
                "registrationEndDate": "1998-01-01",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "1998-01-01",
                "regulatorCode": "PHLX",
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "General Securities Representative",
                "filingDate": "1999-07-05",
                "registrationCategoryCode": "GS",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 361,
                "regulatorName": "NYSE Arca, Inc.",
                "registrationBeginDate": "1992-10-11",
                "registrationEndDate": "1998-01-01",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "1998-01-01",
                "regulatorCode": "NYSE-ARCA",
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "General Securities Sales Supervisor",
                "filingDate": "1999-07-05",
                "registrationCategoryCode": "SU",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 361,
                "regulatorName": "FINRA",
                "registrationBeginDate": "1995-05-31",
                "registrationEndDate": "1998-01-01",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "1998-01-01",
                "regulatorCode": "FINRA",
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "General Securities Sales Supervisor",
                "filingDate": "1999-07-05",
                "registrationCategoryCode": "SU",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 361,
                "regulatorName": "Cboe Exchange, Inc.",
                "registrationBeginDate": "1995-05-31",
                "registrationEndDate": "1998-01-01",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "1998-01-01",
                "regulatorCode": "CBOE",
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "General Securities Sales Supervisor",
                "filingDate": "1999-07-05",
                "registrationCategoryCode": "SU",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 361,
                "regulatorName": "Nasdaq PHLX LLC",
                "registrationBeginDate": "1995-05-31",
                "registrationEndDate": "1998-01-01",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "1998-01-01",
                "regulatorCode": "PHLX",
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "General Securities Sales Supervisor",
                "filingDate": "1999-07-05",
                "registrationCategoryCode": "SU",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 361,
                "regulatorName": "NYSE Arca, Inc.",
                "registrationBeginDate": "1995-05-31",
                "registrationEndDate": "1998-01-01",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "1998-01-01",
                "regulatorCode": "NYSE-ARCA",
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "T_NOU5",
                "registrationCategoryName": "Investment Advisor Representative",
                "filingDate": "2006-03-10",
                "registrationCategoryCode": "RA",
                "registrationStatusName": "Terminated Without U5",
                "firmCrdNumber": 109394,
                "regulatorName": "Idaho",
                "registrationBeginDate": "2006-03-10",
                "registrationEndDate": "2010-04-14",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "2010-04-14",
                "regulatorCode": "ID",
                "firmName": null,
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Investment Advisor Representative",
                "filingDate": "2006-03-10",
                "registrationCategoryCode": "RA",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 116865,
                "regulatorName": "Idaho",
                "registrationBeginDate": "2006-03-10",
                "registrationEndDate": "2022-01-12",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "2022-01-12",
                "regulatorCode": "ID",
                "firmName": "CLEARWATER ADVISORS, LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "T_NOREG",
                "registrationCategoryName": "Agent",
                "filingDate": "2010-06-08",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Termed Without Registration",
                "firmCrdNumber": 153822,
                "regulatorName": "California",
                "registrationBeginDate": null,
                "registrationEndDate": null,
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "2011-04-29",
                "regulatorCode": "CA",
                "firmName": "CLEARWATER SECURITIES, LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "T_NOREG",
                "registrationCategoryName": "Agent",
                "filingDate": "2010-06-08",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Termed Without Registration",
                "firmCrdNumber": 153822,
                "regulatorName": "Idaho",
                "registrationBeginDate": null,
                "registrationEndDate": null,
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "2013-02-22",
                "regulatorCode": "ID",
                "firmName": "CLEARWATER SECURITIES, LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "T_NOREG",
                "registrationCategoryName": "General Securities Representative",
                "filingDate": "2010-06-08",
                "registrationCategoryCode": "GS",
                "registrationStatusName": "Termed Without Registration",
                "firmCrdNumber": 153822,
                "regulatorName": "FINRA",
                "registrationBeginDate": null,
                "registrationEndDate": null,
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "2013-03-07",
                "regulatorCode": "FINRA",
                "firmName": "CLEARWATER SECURITIES, LLC",
                "isApproved": "NO"
            }
        ],
        "individualCrdNumber": 1000018
    }
]

 

Sample Request
https://api.finra.org/data/group/firm/name/inactiveIndividualRegistrationsMock

 

Sample Request Payload
{
"compareFilters": [ 
{"compareType": "equal", "fieldName": "individualCrdNumber", "fieldValue":1000018 }
]
}
 

 

Sample Response
[
    {
        "registrations": [
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Agent",
                "filingDate": "1999-07-05",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 361,
                "regulatorName": "Alaska",
                "registrationBeginDate": "1987-06-10",
                "registrationEndDate": "1998-01-01",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "1998-01-01",
                "regulatorCode": "AK",
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Agent",
                "filingDate": "1999-07-05",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 361,
                "regulatorName": "Arizona",
                "registrationBeginDate": "1987-06-12",
                "registrationEndDate": "1998-01-01",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "1998-01-01",
                "regulatorCode": "AZ",
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Agent",
                "filingDate": "1999-07-05",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 361,
                "regulatorName": "California",
                "registrationBeginDate": "1987-02-02",
                "registrationEndDate": "1998-01-01",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "1998-01-01",
                "regulatorCode": "CA",
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Agent",
                "filingDate": "1999-07-05",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 361,
                "regulatorName": "Colorado",
                "registrationBeginDate": "1987-02-02",
                "registrationEndDate": "1998-01-01",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "1998-01-01",
                "regulatorCode": "CO",
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Agent",
                "filingDate": "1999-07-05",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 361,
                "regulatorName": "Hawaii",
                "registrationBeginDate": "1988-03-02",
                "registrationEndDate": "1998-01-01",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "1998-01-01",
                "regulatorCode": "HI",
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Agent",
                "filingDate": "1999-07-05",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 361,
                "regulatorName": "Idaho",
                "registrationBeginDate": "1987-04-03",
                "registrationEndDate": "1998-01-01",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "1998-01-01",
                "regulatorCode": "ID",
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Agent",
                "filingDate": "1999-07-05",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 361,
                "regulatorName": "Illinois",
                "registrationBeginDate": "1993-12-22",
                "registrationEndDate": "1998-01-01",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "1998-01-01",
                "regulatorCode": "IL",
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Agent",
                "filingDate": "1999-07-05",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 361,
                "regulatorName": "Massachusetts",
                "registrationBeginDate": "1997-01-30",
                "registrationEndDate": "1998-01-01",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "1998-01-01",
                "regulatorCode": "MA",
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Agent",
                "filingDate": "1999-07-05",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 361,
                "regulatorName": "Nevada",
                "registrationBeginDate": "1987-06-10",
                "registrationEndDate": "1998-01-01",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "1998-01-01",
                "regulatorCode": "NV",
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Agent",
                "filingDate": "1999-07-05",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 361,
                "regulatorName": "New Jersey",
                "registrationBeginDate": "1995-11-21",
                "registrationEndDate": "1998-01-01",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "1998-01-01",
                "regulatorCode": "NJ",
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Agent",
                "filingDate": "1999-07-05",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 361,
                "regulatorName": "New Mexico",
                "registrationBeginDate": "1991-12-03",
                "registrationEndDate": "1998-01-01",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "1998-01-01",
                "regulatorCode": "NM",
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Agent",
                "filingDate": "1999-07-05",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 361,
                "regulatorName": "New York",
                "registrationBeginDate": "1989-06-14",
                "registrationEndDate": "1998-01-01",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "1998-01-01",
                "regulatorCode": "NY",
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Agent",
                "filingDate": "1999-07-05",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 361,
                "regulatorName": "Oklahoma",
                "registrationBeginDate": "1988-07-19",
                "registrationEndDate": "1998-01-01",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "1998-01-01",
                "regulatorCode": "OK",
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Agent",
                "filingDate": "1999-07-05",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 361,
                "regulatorName": "Oregon",
                "registrationBeginDate": "1987-02-02",
                "registrationEndDate": "1998-01-01",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "1998-01-01",
                "regulatorCode": "OR",
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Agent",
                "filingDate": "1999-07-05",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 361,
                "regulatorName": "Utah",
                "registrationBeginDate": "1987-06-11",
                "registrationEndDate": "1998-01-01",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "1998-01-01",
                "regulatorCode": "UT",
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Agent",
                "filingDate": "1999-07-05",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 361,
                "regulatorName": "Washington",
                "registrationBeginDate": "1987-06-11",
                "registrationEndDate": "1998-01-01",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "1998-01-01",
                "regulatorCode": "WA",
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Agent",
                "filingDate": "1999-07-05",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 361,
                "regulatorName": "Wyoming",
                "registrationBeginDate": "1987-06-11",
                "registrationEndDate": "1998-01-01",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "1998-01-01",
                "regulatorCode": "WY",
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Branch Office Manager (NYSE)",
                "filingDate": "1999-07-05",
                "registrationCategoryCode": "BM",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 361,
                "regulatorName": "NYSE American LLC",
                "registrationBeginDate": "1995-05-31",
                "registrationEndDate": "1998-01-01",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "1998-01-01",
                "regulatorCode": "NYSE-AMER",
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Branch Office Manager (NYSE)",
                "filingDate": "1999-07-05",
                "registrationCategoryCode": "BM",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 361,
                "regulatorName": "New York Stock Exchange",
                "registrationBeginDate": "1995-05-31",
                "registrationEndDate": "1998-01-01",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "1998-01-01",
                "regulatorCode": "NYSE",
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Foreign Currency Options Representative",
                "filingDate": "1999-07-05",
                "registrationCategoryCode": "FC",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 361,
                "regulatorName": "FINRA",
                "registrationBeginDate": "1983-11-25",
                "registrationEndDate": "1998-01-01",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "1998-01-01",
                "regulatorCode": "FINRA",
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "General Securities Representative",
                "filingDate": "1999-07-05",
                "registrationCategoryCode": "GS",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 361,
                "regulatorName": "FINRA",
                "registrationBeginDate": "1984-02-20",
                "registrationEndDate": "1998-01-01",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "1998-01-01",
                "regulatorCode": "FINRA",
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "General Securities Representative",
                "filingDate": "1999-07-05",
                "registrationCategoryCode": "GS",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 361,
                "regulatorName": "NYSE American LLC",
                "registrationBeginDate": "1988-04-03",
                "registrationEndDate": "1998-01-01",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "1998-01-01",
                "regulatorCode": "NYSE-AMER",
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "General Securities Representative",
                "filingDate": "1999-07-05",
                "registrationCategoryCode": "GS",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 361,
                "regulatorName": "Cboe Exchange, Inc.",
                "registrationBeginDate": "1991-03-03",
                "registrationEndDate": "1998-01-01",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "1998-01-01",
                "regulatorCode": "CBOE",
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "General Securities Representative",
                "filingDate": "1999-07-05",
                "registrationCategoryCode": "GS",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 361,
                "regulatorName": "New York Stock Exchange",
                "registrationBeginDate": "1984-09-14",
                "registrationEndDate": "1998-01-01",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "1998-01-01",
                "regulatorCode": "NYSE",
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "General Securities Representative",
                "filingDate": "1999-07-05",
                "registrationCategoryCode": "GS",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 361,
                "regulatorName": "Nasdaq PHLX LLC",
                "registrationBeginDate": "1993-10-16",
                "registrationEndDate": "1998-01-01",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "1998-01-01",
                "regulatorCode": "PHLX",
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "General Securities Representative",
                "filingDate": "1999-07-05",
                "registrationCategoryCode": "GS",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 361,
                "regulatorName": "NYSE Arca, Inc.",
                "registrationBeginDate": "1992-10-11",
                "registrationEndDate": "1998-01-01",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "1998-01-01",
                "regulatorCode": "NYSE-ARCA",
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "General Securities Sales Supervisor",
                "filingDate": "1999-07-05",
                "registrationCategoryCode": "SU",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 361,
                "regulatorName": "FINRA",
                "registrationBeginDate": "1995-05-31",
                "registrationEndDate": "1998-01-01",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "1998-01-01",
                "regulatorCode": "FINRA",
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "General Securities Sales Supervisor",
                "filingDate": "1999-07-05",
                "registrationCategoryCode": "SU",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 361,
                "regulatorName": "Cboe Exchange, Inc.",
                "registrationBeginDate": "1995-05-31",
                "registrationEndDate": "1998-01-01",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "1998-01-01",
                "regulatorCode": "CBOE",
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "General Securities Sales Supervisor",
                "filingDate": "1999-07-05",
                "registrationCategoryCode": "SU",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 361,
                "regulatorName": "Nasdaq PHLX LLC",
                "registrationBeginDate": "1995-05-31",
                "registrationEndDate": "1998-01-01",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "1998-01-01",
                "regulatorCode": "PHLX",
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "General Securities Sales Supervisor",
                "filingDate": "1999-07-05",
                "registrationCategoryCode": "SU",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 361,
                "regulatorName": "NYSE Arca, Inc.",
                "registrationBeginDate": "1995-05-31",
                "registrationEndDate": "1998-01-01",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "1998-01-01",
                "regulatorCode": "NYSE-ARCA",
                "firmName": "GOLDMAN SACHS & CO. LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "T_NOU5",
                "registrationCategoryName": "Investment Advisor Representative",
                "filingDate": "2006-03-10",
                "registrationCategoryCode": "RA",
                "registrationStatusName": "Terminated Without U5",
                "firmCrdNumber": 109394,
                "regulatorName": "Idaho",
                "registrationBeginDate": "2006-03-10",
                "registrationEndDate": "2010-04-14",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "2010-04-14",
                "regulatorCode": "ID",
                "firmName": null,
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "TERMED",
                "registrationCategoryName": "Investment Advisor Representative",
                "filingDate": "2006-03-10",
                "registrationCategoryCode": "RA",
                "registrationStatusName": "Termed",
                "firmCrdNumber": 116865,
                "regulatorName": "Idaho",
                "registrationBeginDate": "2006-03-10",
                "registrationEndDate": "2022-01-12",
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "2022-01-12",
                "regulatorCode": "ID",
                "firmName": "CLEARWATER ADVISORS, LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "T_NOREG",
                "registrationCategoryName": "Agent",
                "filingDate": "2010-06-08",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Termed Without Registration",
                "firmCrdNumber": 153822,
                "regulatorName": "California",
                "registrationBeginDate": null,
                "registrationEndDate": null,
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "2011-04-29",
                "regulatorCode": "CA",
                "firmName": "CLEARWATER SECURITIES, LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "T_NOREG",
                "registrationCategoryName": "Agent",
                "filingDate": "2010-06-08",
                "registrationCategoryCode": "AG",
                "registrationStatusName": "Termed Without Registration",
                "firmCrdNumber": 153822,
                "regulatorName": "Idaho",
                "registrationBeginDate": null,
                "registrationEndDate": null,
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "2013-02-22",
                "regulatorCode": "ID",
                "firmName": "CLEARWATER SECURITIES, LLC",
                "isApproved": "NO"
            },
            {
                "registrationStatusCode": "T_NOREG",
                "registrationCategoryName": "General Securities Representative",
                "filingDate": "2010-06-08",
                "registrationCategoryCode": "GS",
                "registrationStatusName": "Termed Without Registration",
                "firmCrdNumber": 153822,
                "regulatorName": "FINRA",
                "registrationBeginDate": null,
                "registrationEndDate": null,
                "registrationStatusTypeCode": "INACTIVE",
                "currentStatusDate": "2013-03-07",
                "regulatorCode": "FINRA",
                "firmName": "CLEARWATER SECURITIES, LLC",
                "isApproved": "NO"
            }
        ],
        "individualCrdNumber": 1000018
    }
]

 

Individual Registration Validation

Validate the registration status of a registered individual with FINRA and the states independent of what firm they are affiliated with.

Dataset Info:

group dataset test dataset
registration registrationValidationIndividual registrationValidationIndividualMock

 

    Terms of Service

    Access to the Individual Registration Validation dataset is governed by specific Terms of Service.

    The specific Terms of Service for the Registration datasets are included by reference in the FINRA API Terms of Service.

    This endpoint allows FINRA member firms, as well as other financial services industry participants (e.g. insurance companies, mutual fund organizations, transfer agents, clearing firms, service providers, and FinTech solution providers) to validate the registration status of an individual, regardless of the individual's firm affiliation.

    The scope of individuals included in this dataset include active registered individuals who are currently registered with a broker-dealer (inclusive of individuals registered as both RR & IAR). IA Only registered individuals are not included in this dataset.

    This endpoint follows the Single Record Dataset structure: /data/group/{group name}/name/{dataset name}/id/{id} where the {id} field represents and individual CRD number.

    The request will return either a 404 error code, if the individual CRD# is not found/invalid, or a response payload containing the following information for a valid CRD#:

    1. Basic Information: Name, Individual CRD# 

    1. Current Employment: Firm Name and Firm CRD# 

    1. Registered States: State Name and Registration Status 

    1. Registered SROs: SRO Name and Registration Status

    To test this endpoint create a Test Credential using the API Console and use of the following test individual CRD numbers:

    • 1234567
    • 135712

    These CRD numbers will return the payloads shown in the sample requests/response sections below.

    A CRD number such as 123456789 will return a 404 code for testing purposes.

    Sample Request #1
    https://api.finra.org/data/group/registration/name/registrationvalidationindividualmock/id/1234567 
    
    

     

    Sample Response #1
    {
        "firstName": "John",
        "lastName": "Doe",
        "registrations": [
            {
                "regulatorName": "FINRA",
                "isInactiveOrSuspended": "no"
            },
            {
                "regulatorName": "Colorado",
                "isInactiveOrSuspended": "no"
            },
            {
                "regulatorName": "Connecticut",
                "isInactiveOrSuspended": "yes"
            }
        ],
        "suffixName": null,
        "middleName": "Kent",
        "employments": [
            {
                "doingBusinessAsName": "Metropolis Markets, INC.",
                "firmCrdNumber": 11111,
                "isActive": "yes"
            },
            {
                "doingBusinessAsName": "Gotham Investments, INC.",
                "firmCrdNumber": 22222,
                "isActive": "yes"
            }
        ],
        "individualCrdNumber": 1234567
    }

     

     

    Sample Request #2
    https://api.finra.org/data/group/registration/name/registrationvalidationindividualmock/id/135712

     

    Sample Response #2
    {
        "firstName": "Tom",
        "lastName": "Doe",
        "registrations": [
            {
                "regulatorName": "FINRA",
                "isInactiveOrSuspended": "no"
            }
        ],
        "suffixName": null,
        "middleName": "Stark",
        "employments": [
            {
                "doingBusinessAsName": "Stark Capital, INC.",
                "firmCrdNumber": 45623,
                "isActive": "yes"
            }
        ],
        "individualCrdNumber": null
    }

     

    Professional Designations

    Detailed professional designation information for a registered individual.

    Dataset Info:

    group dataset test dataset
    firm registeredIndividualProfessionalDesignations registeredIndividualProfessionalDesignationsMock

     

    Sample Request
    https://api.finra.org/data/group/firm/name/registeredIndividualProfessionalDesignationsMock?limit=5

     

    Sample Response
    [
        {
            "registrations": [
                {
                    "regulatorCode": "NQX"
                },
                {
                    "regulatorCode": "NYSE-AMER"
                }
            ],
            "employments": [
                {
                    "firmCrdNumber": 3000005
                }
            ],
            "individualCrdNumber": 1,
            "professionalDesignations": [
                {
                    "designationTypeName": "Chartered Financial Analyst",
                    "firstFilingFirmCrdNumber": 3000005,
                    "firstFilingType": "U4",
                    "lastFilingDate": null,
                    "firstFilingFirmName": "VIRGILIO CAPITAL SERVICES, INC.",
                    "designationAuthorityName": "CFA Institute",
                    "firstFilingDate": "2002-10-15",
                    "lastFilingType": null,
                    "designationTypeCode": "CFA",
                    "lastFilingFirmCrdNumber": null,
                    "lastFilingFirmName": null
                }
            ]
        },
        {
            "registrations": [
                {
                    "regulatorCode": "NYSE-AMER"
                },
                {
                    "regulatorCode": "NQX"
                }
            ],
            "employments": [
                {
                    "firmCrdNumber": 3000005
                }
            ],
            "individualCrdNumber": 10,
            "professionalDesignations": [
                {
                    "designationTypeName": "Personal Financial Specialist",
                    "firstFilingFirmCrdNumber": 3000005,
                    "firstFilingType": "U4",
                    "lastFilingDate": null,
                    "firstFilingFirmName": "MAC INSURANCE SERVICES, INC.",
                    "designationAuthorityName": "American Institute of Certified Public Accountants",
                    "firstFilingDate": "2014-08-25",
                    "lastFilingType": null,
                    "designationTypeCode": "PFS",
                    "lastFilingFirmCrdNumber": null,
                    "lastFilingFirmName": null
                }
            ]
        },
        {
            "registrations": [
                {
                    "regulatorCode": "CBOE C2"
                },
                {
                    "regulatorCode": "MEMX"
                }
            ],
            "employments": [
                {
                    "firmCrdNumber": 3000005
                }
            ],
            "individualCrdNumber": 100
        },
        {
            "registrations": [
                {
                    "regulatorCode": "MIAX OPTIONS"
                },
                {
                    "regulatorCode": "NYSE-AMER"
                }
            ],
            "employments": [
                {
                    "firmCrdNumber": 3000005
                }
            ],
            "individualCrdNumber": 1000
        },
        {
            "registrations": [
                {
                    "regulatorCode": "NYSE-CHI"
                },
                {
                    "regulatorCode": "HI"
                }
            ],
            "employments": [
                {
                    "firmCrdNumber": 3000005
                },
                {
                    "firmCrdNumber": 3000005
                }
            ],
            "individualCrdNumber": 10000
        }
    ]

     

    Sample Request
    https://api.finra.org/data/group/firm/name/registeredIndividualProfessionalDesignationsMock

     

    Sample Request Payload
    {
    "compareFilters": [ 
    {"compareType": "equal", "fieldName": "individualCrdNumber", "fieldValue":10 }
    ]
    }
     

     

    Sample Response
    [
        {
            "registrations": [
                {
                    "regulatorCode": "NYSE-AMER"
                },
                {
                    "regulatorCode": "NQX"
                }
            ],
            "employments": [
                {
                    "firmCrdNumber": 3000005
                }
            ],
            "individualCrdNumber": 10,
            "professionalDesignations": [
                {
                    "designationTypeName": "Personal Financial Specialist",
                    "firstFilingFirmCrdNumber": 3000005,
                    "firstFilingType": "U4",
                    "lastFilingDate": null,
                    "firstFilingFirmName": "MAC INSURANCE SERVICES, INC.",
                    "designationAuthorityName": "American Institute of Certified Public Accountants",
                    "firstFilingDate": "2014-08-25",
                    "lastFilingType": null,
                    "designationTypeCode": "PFS",
                    "lastFilingFirmCrdNumber": null,
                    "lastFilingFirmName": null
                }
            ]
        }
    ]

     

    Qualification Exams

    Detailed information about the examination status of a registered individual.

    Dataset Info:

    group dataset test dataset
    firm registeredIndividualExams registeredIndividualExamsMock

     

    Sample Request
    https://api.finra.org/data/group/firm/name/registeredIndividualExamsMock?limit=5

     

    Sample Response
    [
        {
            "registrations": [
                {
                    "regulatorCode": "NQX"
                },
                {
                    "regulatorCode": "NYSE-AMER"
                }
            ],
            "employments": [
                {
                    "firmCrdNumber": 3000005
                }
            ],
            "individualCrdNumber": 1
        },
        {
            "registrations": [
                {
                    "regulatorCode": "NYSE-AMER"
                },
                {
                    "regulatorCode": "NQX"
                }
            ],
            "exams": [
                {
                    "examValidityFlag": null,
                    "testCenterName": null,
                    "appointmentStatusCode": null,
                    "examCode": "S27",
                    "testCenterId": null,
                    "windowBeginDate": "2008-11-01",
                    "examPendingFlag": null,
                    "examStatusDate": "2008-12-24",
                    "examValidityUntilDate": "2010-12-24",
                    "vendor": null,
                    "examValidityStatus": "EXPIRED",
                    "testCenterCountry": null,
                    "examTakenDate": "2008-12-24",
                    "examName": "Financial and Operations Principal Examination",
                    "examStatus": "OFFICIAL_RESULT",
                    "waivedByRegulatorCode": null,
                    "waiverReasonName": null,
                    "windowEndDate": "2009-01-01",
                    "examGradeCode": "PASSED",
                    "waivedByRegulatorName": null,
                    "confirmationNumber": null,
                    "testCenterCity": null,
                    "examScore": null,
                    "testCenterState": null,
                    "appointmentDate": null
                },
                {
                    "examValidityFlag": null,
                    "testCenterName": null,
                    "appointmentStatusCode": null,
                    "examCode": "S37",
                    "testCenterId": null,
                    "windowBeginDate": "2013-02-01",
                    "examPendingFlag": null,
                    "examStatusDate": "2013-03-12",
                    "examValidityUntilDate": "2015-03-12",
                    "vendor": null,
                    "examValidityStatus": "EXPIRED",
                    "testCenterCountry": null,
                    "examTakenDate": "2013-03-12",
                    "examName": "Canada Module of the General Securities Registered Representative (With Options Questions)",
                    "examStatus": "OFFICIAL_RESULT",
                    "waivedByRegulatorCode": null,
                    "waiverReasonName": null,
                    "windowEndDate": "2013-04-01",
                    "examGradeCode": "PASSED",
                    "waivedByRegulatorName": null,
                    "confirmationNumber": null,
                    "testCenterCity": null,
                    "examScore": null,
                    "testCenterState": null,
                    "appointmentDate": null
                },
                {
                    "examValidityFlag": null,
                    "testCenterName": "ofNjVWhCgpRsOWgwftes",
                    "appointmentStatusCode": null,
                    "examCode": "S54",
                    "testCenterId": -3435586610866399980,
                    "windowBeginDate": "2012-11-01",
                    "examPendingFlag": null,
                    "examStatusDate": "2012-12-16",
                    "examValidityUntilDate": "2014-12-16",
                    "vendor": null,
                    "examValidityStatus": "EXPIRED",
                    "testCenterCountry": "USA",
                    "examTakenDate": "2012-12-16",
                    "examName": "Municipal Securities Financial and Operations Principal Examination",
                    "examStatus": "SCHEDULED",
                    "waivedByRegulatorCode": null,
                    "waiverReasonName": null,
                    "windowEndDate": "2013-01-01",
                    "examGradeCode": "FAILED",
                    "waivedByRegulatorName": null,
                    "confirmationNumber": "5445289533",
                    "testCenterCity": "pJqepvQaRK",
                    "examScore": 44,
                    "testCenterState": "EK",
                    "appointmentDate": null
                }
            ],
            "employments": [
                {
                    "firmCrdNumber": 3000005
                }
            ],
            "individualCrdNumber": 10
        },
        {
            "registrations": [
                {
                    "regulatorCode": "CBOE C2"
                },
                {
                    "regulatorCode": "MEMX"
                }
            ],
            "exams": [
                {
                    "examValidityFlag": null,
                    "testCenterName": "nPtVCyHUBvRlMIuARRkr",
                    "appointmentStatusCode": null,
                    "examCode": "S33",
                    "testCenterId": -2774730915379793468,
                    "windowBeginDate": "2016-03-01",
                    "examPendingFlag": null,
                    "examStatusDate": "2016-04-11",
                    "examValidityUntilDate": "2018-04-11",
                    "vendor": null,
                    "examValidityStatus": "EXPIRED",
                    "testCenterCountry": "USA",
                    "examTakenDate": "2016-04-11",
                    "examName": "Financial Instruments Examination",
                    "examStatus": "RESCHEDULED",
                    "waivedByRegulatorCode": null,
                    "waiverReasonName": null,
                    "windowEndDate": "2016-05-01",
                    "examGradeCode": "PASSED",
                    "waivedByRegulatorName": null,
                    "confirmationNumber": "2118770258",
                    "testCenterCity": "RInaeFQKWg",
                    "examScore": null,
                    "testCenterState": "VS",
                    "appointmentDate": null
                },
                {
                    "examValidityFlag": null,
                    "testCenterName": "irvBLXWQNqCdJeODXBuH",
                    "appointmentStatusCode": null,
                    "examCode": "S46",
                    "testCenterId": 5336380999444383148,
                    "windowBeginDate": "2007-06-01",
                    "examPendingFlag": null,
                    "examStatusDate": "2007-07-19",
                    "examValidityUntilDate": "2009-07-19",
                    "vendor": null,
                    "examValidityStatus": "EXPIRED",
                    "testCenterCountry": "USA",
                    "examTakenDate": "2007-07-19",
                    "examName": "PCX Market Maker acting as a Floor Broker Exam",
                    "examStatus": "RESCHEDULED",
                    "waivedByRegulatorCode": null,
                    "waiverReasonName": null,
                    "windowEndDate": "2007-08-01",
                    "examGradeCode": "PASSED",
                    "waivedByRegulatorName": null,
                    "confirmationNumber": "8946944742",
                    "testCenterCity": "uRpMcBTtvs",
                    "examScore": null,
                    "testCenterState": "KF",
                    "appointmentDate": null
                },
                {
                    "examValidityFlag": null,
                    "testCenterName": "eLWcmIlwCyCIYbIXZVqW",
                    "appointmentStatusCode": null,
                    "examCode": "S54",
                    "testCenterId": -1705362706495635752,
                    "windowBeginDate": "2015-09-01",
                    "examPendingFlag": null,
                    "examStatusDate": "2015-09-16",
                    "examValidityUntilDate": "2017-09-16",
                    "vendor": null,
                    "examValidityStatus": "EXPIRED",
                    "testCenterCountry": "USA",
                    "examTakenDate": "2015-09-16",
                    "examName": "Municipal Securities Financial and Operations Principal Examination",
                    "examStatus": "SCHEDULED",
                    "waivedByRegulatorCode": null,
                    "waiverReasonName": null,
                    "windowEndDate": "2015-11-01",
                    "examGradeCode": "FAILED",
                    "waivedByRegulatorName": null,
                    "confirmationNumber": "8162986506",
                    "testCenterCity": "YBFZIyotAM",
                    "examScore": 14,
                    "testCenterState": "XH",
                    "appointmentDate": null
                },
                {
                    "examValidityFlag": null,
                    "testCenterName": "HkZVcVFqzUFndfqDFmNx",
                    "appointmentStatusCode": null,
                    "examCode": "S28",
                    "testCenterId": 152792623342201224,
                    "windowBeginDate": "2007-07-01",
                    "examPendingFlag": null,
                    "examStatusDate": "2007-07-16",
                    "examValidityUntilDate": "2009-07-16",
                    "vendor": null,
                    "examValidityStatus": "EXPIRED",
                    "testCenterCountry": "USA",
                    "examTakenDate": "2007-07-16",
                    "examName": "Introducing Broker/Dealer Financial Operations Principal Examination",
                    "examStatus": "SCHEDULED",
                    "waivedByRegulatorCode": null,
                    "waiverReasonName": null,
                    "windowEndDate": "2007-09-01",
                    "examGradeCode": "FAILED",
                    "waivedByRegulatorName": null,
                    "confirmationNumber": "3122176820",
                    "testCenterCity": "gBhOzdaIqE",
                    "examScore": 1,
                    "testCenterState": "WK",
                    "appointmentDate": null
                }
            ],
            "employments": [
                {
                    "firmCrdNumber": 3000005
                }
            ],
            "individualCrdNumber": 100
        },
        {
            "registrations": [
                {
                    "regulatorCode": "MIAX OPTIONS"
                },
                {
                    "regulatorCode": "NYSE-AMER"
                }
            ],
            "exams": [
                {
                    "examValidityFlag": null,
                    "testCenterName": null,
                    "appointmentStatusCode": null,
                    "examCode": "S14",
                    "testCenterId": null,
                    "windowBeginDate": "2008-06-01",
                    "examPendingFlag": null,
                    "examStatusDate": "2008-06-25",
                    "examValidityUntilDate": "2010-06-25",
                    "vendor": null,
                    "examValidityStatus": "EXPIRED",
                    "testCenterCountry": null,
                    "examTakenDate": "2008-06-25",
                    "examName": "Compliance Officer Examination",
                    "examStatus": "WITHDRAW",
                    "waivedByRegulatorCode": null,
                    "waiverReasonName": null,
                    "windowEndDate": "2008-08-01",
                    "examGradeCode": "FAILED",
                    "waivedByRegulatorName": null,
                    "confirmationNumber": null,
                    "testCenterCity": null,
                    "examScore": 48,
                    "testCenterState": null,
                    "appointmentDate": null
                },
                {
                    "examValidityFlag": null,
                    "testCenterName": null,
                    "appointmentStatusCode": null,
                    "examCode": "S901",
                    "testCenterId": null,
                    "windowBeginDate": "2010-07-01",
                    "examPendingFlag": null,
                    "examStatusDate": "2010-07-03",
                    "examValidityUntilDate": "2012-07-03",
                    "vendor": null,
                    "examValidityStatus": "EXPIRED",
                    "testCenterCountry": null,
                    "examTakenDate": "2010-07-03",
                    "examName": "S901",
                    "examStatus": "WITHDRAW",
                    "waivedByRegulatorCode": null,
                    "waiverReasonName": null,
                    "windowEndDate": "2010-09-01",
                    "examGradeCode": "FAILED",
                    "waivedByRegulatorName": null,
                    "confirmationNumber": null,
                    "testCenterCity": null,
                    "examScore": 19,
                    "testCenterState": null,
                    "appointmentDate": null
                }
            ],
            "employments": [
                {
                    "firmCrdNumber": 3000005
                }
            ],
            "individualCrdNumber": 1000
        },
        {
            "registrations": [
                {
                    "regulatorCode": "NYSE-CHI"
                },
                {
                    "regulatorCode": "HI"
                }
            ],
            "exams": [
                {
                    "examValidityFlag": null,
                    "testCenterName": null,
                    "appointmentStatusCode": null,
                    "examCode": "S201",
                    "testCenterId": null,
                    "windowBeginDate": "2000-09-01",
                    "examPendingFlag": null,
                    "examStatusDate": "2000-10-14",
                    "examValidityUntilDate": "2002-10-14",
                    "vendor": null,
                    "examValidityStatus": "EXPIRED",
                    "testCenterCountry": null,
                    "examTakenDate": "2000-10-14",
                    "examName": "S201",
                    "examStatus": "OFFICIAL_RESULT",
                    "waivedByRegulatorCode": null,
                    "waiverReasonName": null,
                    "windowEndDate": "2000-11-01",
                    "examGradeCode": "PASSED",
                    "waivedByRegulatorName": null,
                    "confirmationNumber": null,
                    "testCenterCity": null,
                    "examScore": null,
                    "testCenterState": null,
                    "appointmentDate": null
                },
                {
                    "examValidityFlag": null,
                    "testCenterName": null,
                    "appointmentStatusCode": null,
                    "examCode": "S14A",
                    "testCenterId": null,
                    "windowBeginDate": "2004-01-01",
                    "examPendingFlag": null,
                    "examStatusDate": "2004-01-15",
                    "examValidityUntilDate": "2006-01-15",
                    "vendor": null,
                    "examValidityStatus": "EXPIRED",
                    "testCenterCountry": null,
                    "examTakenDate": "2004-01-15",
                    "examName": "Compliance Official Specialist Exam",
                    "examStatus": "OFFICIAL_RESULT",
                    "waivedByRegulatorCode": null,
                    "waiverReasonName": null,
                    "windowEndDate": "2004-03-01",
                    "examGradeCode": "PASSED",
                    "waivedByRegulatorName": null,
                    "confirmationNumber": null,
                    "testCenterCity": null,
                    "examScore": null,
                    "testCenterState": null,
                    "appointmentDate": null
                },
                {
                    "examValidityFlag": null,
                    "testCenterName": "JclfJnrGlXgnwGZoDRcP",
                    "appointmentStatusCode": null,
                    "examCode": "S2",
                    "testCenterId": -7130959705640416347,
                    "windowBeginDate": "2008-11-01",
                    "examPendingFlag": null,
                    "examStatusDate": "2008-12-30",
                    "examValidityUntilDate": "2010-12-30",
                    "vendor": null,
                    "examValidityStatus": "EXPIRED",
                    "testCenterCountry": "USA",
                    "examTakenDate": "2008-12-30",
                    "examName": "Non-Member General Securities Examination",
                    "examStatus": "RESCHEDULED",
                    "waivedByRegulatorCode": null,
                    "waiverReasonName": null,
                    "windowEndDate": "2009-01-01",
                    "examGradeCode": "PASSED",
                    "waivedByRegulatorName": null,
                    "confirmationNumber": "4920206534",
                    "testCenterCity": "FWFOYAaEOs",
                    "examScore": null,
                    "testCenterState": "CV",
                    "appointmentDate": null
                },
                {
                    "examValidityFlag": null,
                    "testCenterName": "PvjQfXlXnsACDStiqsCC",
                    "appointmentStatusCode": null,
                    "examCode": "S19",
                    "testCenterId": -6033378647599482690,
                    "windowBeginDate": "2014-05-01",
                    "examPendingFlag": null,
                    "examStatusDate": "2014-05-31",
                    "examValidityUntilDate": "2016-05-31",
                    "vendor": null,
                    "examValidityStatus": "EXPIRED",
                    "testCenterCountry": "USA",
                    "examTakenDate": "2014-05-31",
                    "examName": "NYSE Floor Clerk - Equities Examination",
                    "examStatus": "SCHEDULED",
                    "waivedByRegulatorCode": null,
                    "waiverReasonName": null,
                    "windowEndDate": "2014-07-01",
                    "examGradeCode": "FAILED",
                    "waivedByRegulatorName": null,
                    "confirmationNumber": "2191452795",
                    "testCenterCity": "XgSdofSCWh",
                    "examScore": 48,
                    "testCenterState": "PX",
                    "appointmentDate": null
                },
                {
                    "examValidityFlag": null,
                    "testCenterName": null,
                    "appointmentStatusCode": null,
                    "examCode": "S87",
                    "testCenterId": null,
                    "windowBeginDate": "2002-05-01",
                    "examPendingFlag": null,
                    "examStatusDate": "2002-05-19",
                    "examValidityUntilDate": "2004-05-19",
                    "vendor": null,
                    "examValidityStatus": "EXPIRED",
                    "testCenterCountry": null,
                    "examTakenDate": "2002-05-19",
                    "examName": "Research Analyst Exam - Part II Regulations Module",
                    "examStatus": "OFFICIAL_RESULT",
                    "waivedByRegulatorCode": null,
                    "waiverReasonName": null,
                    "windowEndDate": "2002-07-01",
                    "examGradeCode": "PASSED",
                    "waivedByRegulatorName": null,
                    "confirmationNumber": null,
                    "testCenterCity": null,
                    "examScore": null,
                    "testCenterState": null,
                    "appointmentDate": null
                },
                {
                    "examValidityFlag": null,
                    "testCenterName": null,
                    "appointmentStatusCode": null,
                    "examCode": "S47",
                    "testCenterId": null,
                    "windowBeginDate": "2014-08-01",
                    "examPendingFlag": null,
                    "examStatusDate": "2014-08-15",
                    "examValidityUntilDate": "2016-08-15",
                    "vendor": null,
                    "examValidityStatus": "EXPIRED",
                    "testCenterCountry": null,
                    "examTakenDate": "2014-08-15",
                    "examName": "S47",
                    "examStatus": "WITHDRAW",
                    "waivedByRegulatorCode": null,
                    "waiverReasonName": null,
                    "windowEndDate": "2014-10-01",
                    "examGradeCode": "FAILED",
                    "waivedByRegulatorName": null,
                    "confirmationNumber": null,
                    "testCenterCity": null,
                    "examScore": 12,
                    "testCenterState": null,
                    "appointmentDate": null
                }
            ],
            "employments": [
                {
                    "firmCrdNumber": 3000005
                },
                {
                    "firmCrdNumber": 3000005
                }
            ],
            "individualCrdNumber": 10000
        }
    ]

     

    Sample Request
    https://api.finra.org/data/group/firm/name/registeredIndividualExamsMock

     

    Sample Request Payload
    {
    "compareFilters": [ 
    {"compareType": "equal", "fieldName": "individualCrdNumber", "fieldValue":10 }
    ]
    }
     

     

    Sample Response
    [
        {
            "registrations": [
                {
                    "regulatorCode": "NYSE-AMER"
                },
                {
                    "regulatorCode": "NQX"
                }
            ],
            "exams": [
                {
                    "examValidityFlag": null,
                    "testCenterName": null,
                    "appointmentStatusCode": null,
                    "examCode": "S27",
                    "testCenterId": null,
                    "windowBeginDate": "2008-11-01",
                    "examPendingFlag": null,
                    "examStatusDate": "2008-12-24",
                    "examValidityUntilDate": "2010-12-24",
                    "vendor": null,
                    "examValidityStatus": "EXPIRED",
                    "testCenterCountry": null,
                    "examTakenDate": "2008-12-24",
                    "examName": "Financial and Operations Principal Examination",
                    "examStatus": "OFFICIAL_RESULT",
                    "waivedByRegulatorCode": null,
                    "waiverReasonName": null,
                    "windowEndDate": "2009-01-01",
                    "examGradeCode": "PASSED",
                    "waivedByRegulatorName": null,
                    "confirmationNumber": null,
                    "testCenterCity": null,
                    "examScore": null,
                    "testCenterState": null,
                    "appointmentDate": null
                },
                {
                    "examValidityFlag": null,
                    "testCenterName": null,
                    "appointmentStatusCode": null,
                    "examCode": "S37",
                    "testCenterId": null,
                    "windowBeginDate": "2013-02-01",
                    "examPendingFlag": null,
                    "examStatusDate": "2013-03-12",
                    "examValidityUntilDate": "2015-03-12",
                    "vendor": null,
                    "examValidityStatus": "EXPIRED",
                    "testCenterCountry": null,
                    "examTakenDate": "2013-03-12",
                    "examName": "Canada Module of the General Securities Registered Representative (With Options Questions)",
                    "examStatus": "OFFICIAL_RESULT",
                    "waivedByRegulatorCode": null,
                    "waiverReasonName": null,
                    "windowEndDate": "2013-04-01",
                    "examGradeCode": "PASSED",
                    "waivedByRegulatorName": null,
                    "confirmationNumber": null,
                    "testCenterCity": null,
                    "examScore": null,
                    "testCenterState": null,
                    "appointmentDate": null
                },
                {
                    "examValidityFlag": null,
                    "testCenterName": "ofNjVWhCgpRsOWgwftes",
                    "appointmentStatusCode": null,
                    "examCode": "S54",
                    "testCenterId": -3435586610866399980,
                    "windowBeginDate": "2012-11-01",
                    "examPendingFlag": null,
                    "examStatusDate": "2012-12-16",
                    "examValidityUntilDate": "2014-12-16",
                    "vendor": null,
                    "examValidityStatus": "EXPIRED",
                    "testCenterCountry": "USA",
                    "examTakenDate": "2012-12-16",
                    "examName": "Municipal Securities Financial and Operations Principal Examination",
                    "examStatus": "SCHEDULED",
                    "waivedByRegulatorCode": null,
                    "waiverReasonName": null,
                    "windowEndDate": "2013-01-01",
                    "examGradeCode": "FAILED",
                    "waivedByRegulatorName": null,
                    "confirmationNumber": "5445289533",
                    "testCenterCity": "pJqepvQaRK",
                    "examScore": 44,
                    "testCenterState": "EK",
                    "appointmentDate": null
                }
            ],
            "employments": [
                {
                    "firmCrdNumber": 3000005
                }
            ],
            "individualCrdNumber": 10
        }
    ]

     

    Registered Individuals

    Basic information about all individuals currently and formerly employed by a firm.

    Dataset Info:

    group dataset test dataset
    firm registeredIndividual registeredIndividualMock

     

    Sample Request
    https://api.finra.org/data/group/firm/name/registeredIndividualMock?limit=5

     

    Sample Response
    [
        {
            "lastName": "Membiela",
            "investmentAdvisorAffiliations": [
                {
                    "affiliationFirmName": "QjjQbekPOdYDAvGKhUwb",
                    "affiliationFirmCrdNumber": 6862541356646069356,
                    "affiliationType": "relying advisor control person"
                }
            ],
            "attestationStatus": null,
            "statutoryDisqualification": null,
            "registrations": [
                {
                    "regulatorCode": "NQX"
                },
                {
                    "regulatorCode": "NYSE-AMER"
                }
            ],
            "wasAssociatedWithDisciplinedFirmFlag": null,
            "finproAccountCreateDate": null,
            "finproUserFlag": "NO",
            "employments": [
                {
                    "firmCrdNumber": 3000005,
                    "isActive": "YES"
                }
            ],
            "attestationStatusTimestamp": null,
            "firstName": "Derayne",
            "finproLastAccessDate": null,
            "statutoryDisqualificationCode": null,
            "otherBusiness": null,
            "middleName": null,
            "outsideBusinessFlag": "NO",
            "individualCrdNumber": 1
        },
        {
            "lastName": "Portela",
            "investmentAdvisorAffiliations": [
                {
                    "affiliationFirmName": "WjcIvcDVxzpDzSpUIpcK",
                    "affiliationFirmCrdNumber": 5293805205696410237,
                    "affiliationType": "relying advisor control person"
                }
            ],
            "attestationStatus": null,
            "statutoryDisqualification": null,
            "registrations": [
                {
                    "regulatorCode": "NYSE-AMER"
                },
                {
                    "regulatorCode": "NQX"
                }
            ],
            "wasAssociatedWithDisciplinedFirmFlag": null,
            "finproAccountCreateDate": null,
            "finproUserFlag": "NO",
            "employments": [
                {
                    "firmCrdNumber": 3000005,
                    "isActive": "YES"
                }
            ],
            "attestationStatusTimestamp": null,
            "firstName": "Jourdan",
            "finproLastAccessDate": null,
            "statutoryDisqualificationCode": null,
            "otherBusiness": null,
            "middleName": null,
            "outsideBusinessFlag": "NO",
            "individualCrdNumber": 10
        },
        {
            "lastName": "Olaciregui",
            "investmentAdvisorAffiliations": [
                {
                    "affiliationFirmName": "vmxFBrUGmjdNqbeBcihr",
                    "affiliationFirmCrdNumber": -3030638805770951705,
                    "affiliationType": "relying advisor control person"
                }
            ],
            "attestationStatus": null,
            "statutoryDisqualification": null,
            "registrations": [
                {
                    "regulatorCode": "CBOE C2"
                },
                {
                    "regulatorCode": "MEMX"
                }
            ],
            "wasAssociatedWithDisciplinedFirmFlag": null,
            "finproAccountCreateDate": null,
            "finproUserFlag": "NO",
            "employments": [
                {
                    "firmCrdNumber": 3000005,
                    "isActive": "YES"
                }
            ],
            "attestationStatusTimestamp": null,
            "firstName": "Loise",
            "finproLastAccessDate": null,
            "statutoryDisqualificationCode": null,
            "otherBusiness": null,
            "middleName": "Holtorf",
            "outsideBusinessFlag": "NO",
            "individualCrdNumber": 100
        },
        {
            "lastName": "Perez De Heredia",
            "investmentAdvisorAffiliations": [
                {
                    "affiliationFirmName": "PiNWIPkAXSNKSBTdtQka",
                    "affiliationFirmCrdNumber": 1354592929594687791,
                    "affiliationType": "relying advisor control person"
                }
            ],
            "attestationStatus": "Data Correct",
            "statutoryDisqualification": null,
            "registrations": [
                {
                    "regulatorCode": "MIAX OPTIONS"
                },
                {
                    "regulatorCode": "NYSE-AMER"
                }
            ],
            "wasAssociatedWithDisciplinedFirmFlag": null,
            "finproAccountCreateDate": "2018-05-21",
            "finproAttestations": [
                {
                    "attestationStatus": "Data Correct",
                    "attestationStatusTimestamp": "2021-07-14 18:08:14"
                },
                {
                    "attestationStatus": "Data Incorrect",
                    "attestationStatusTimestamp": "2021-07-14 17:08:14"
                }
            ],
            "finproUserFlag": "YES",
            "employments": [
                {
                    "firmCrdNumber": 3000005,
                    "isActive": "YES"
                }
            ],
            "attestationStatusTimestamp": "2021-07-14 18:08:14",
            "firstName": "Bernie",
            "finproLastAccessDate": "2018-10-08",
            "statutoryDisqualificationCode": null,
            "otherBusiness": null,
            "middleName": null,
            "outsideBusinessFlag": "NO",
            "individualCrdNumber": 1000
        },
        {
            "lastName": "Fabios",
            "investmentAdvisorAffiliations": [
                {
                    "affiliationFirmName": "jifOMjxQFsIhzFpRMyIL",
                    "affiliationFirmCrdNumber": -8234046724254127978,
                    "affiliationType": "direct owner"
                }
            ],
            "attestationStatus": null,
            "statutoryDisqualification": null,
            "registrations": [
                {
                    "regulatorCode": "NYSE-CHI"
                },
                {
                    "regulatorCode": "HI"
                }
            ],
            "wasAssociatedWithDisciplinedFirmFlag": null,
            "finproAccountCreateDate": null,
            "finproUserFlag": "NO",
            "employments": [
                {
                    "firmCrdNumber": 3000005,
                    "isActive": "YES"
                },
                {
                    "firmCrdNumber": 3000005,
                    "isActive": "YES"
                }
            ],
            "attestationStatusTimestamp": null,
            "firstName": "Susanna",
            "finproLastAccessDate": null,
            "statutoryDisqualificationCode": null,
            "otherBusiness": null,
            "middleName": null,
            "outsideBusinessFlag": "NO",
            "individualCrdNumber": 10000
        }
    ]

     

    Sample Request
    https://api.finra.org/data/group/firm/name/registeredIndividualMock

     

    Sample Request Payload
    {
    "compareFilters": [ 
    {"compareType": "lesser", "fieldName": "individualCrdNumber", "fieldValue":10 }
    ]
    }
     

     

    Sample Response
    [
        {
            "lastName": "Membiela",
            "investmentAdvisorAffiliations": [
                {
                    "affiliationFirmName": "QjjQbekPOdYDAvGKhUwb",
                    "affiliationFirmCrdNumber": 6862541356646069356,
                    "affiliationType": "relying advisor control person"
                }
            ],
            "attestationStatus": null,
            "statutoryDisqualification": null,
            "registrations": [
                {
                    "regulatorCode": "NQX"
                },
                {
                    "regulatorCode": "NYSE-AMER"
                }
            ],
            "wasAssociatedWithDisciplinedFirmFlag": null,
            "finproAccountCreateDate": null,
            "finproUserFlag": "NO",
            "employments": [
                {
                    "firmCrdNumber": 3000005,
                    "isActive": "YES"
                }
            ],
            "attestationStatusTimestamp": null,
            "firstName": "Derayne",
            "finproLastAccessDate": null,
            "statutoryDisqualificationCode": null,
            "otherBusiness": null,
            "middleName": null,
            "outsideBusinessFlag": "NO",
            "individualCrdNumber": 1
        },
        {
            "lastName": "Combalia",
            "investmentAdvisorAffiliations": [
                {
                    "affiliationFirmName": "ZIAIQRHifGGbbhjvwoVV",
                    "affiliationFirmCrdNumber": 2069419612488707219,
                    "affiliationType": "indirect owner"
                }
            ],
            "attestationStatus": null,
            "statutoryDisqualification": null,
            "registrations": [
                {
                    "regulatorCode": "ISE"
                },
                {
                    "regulatorCode": "NYSE-AMER"
                }
            ],
            "wasAssociatedWithDisciplinedFirmFlag": null,
            "finproAccountCreateDate": null,
            "finproUserFlag": "NO",
            "employments": [
                {
                    "firmCrdNumber": 3000005,
                    "isActive": "YES"
                },
                {
                    "firmCrdNumber": 3000005,
                    "isActive": "YES"
                }
            ],
            "attestationStatusTimestamp": null,
            "firstName": "Geesey",
            "finproLastAccessDate": null,
            "statutoryDisqualificationCode": null,
            "otherBusiness": null,
            "middleName": null,
            "outsideBusinessFlag": "NO",
            "individualCrdNumber": 2
        },
        {
            "lastName": "Urkizu",
            "investmentAdvisorAffiliations": [
                {
                    "affiliationFirmName": "FdlbZzplAuzeNKiyoqPt",
                    "affiliationFirmCrdNumber": 3998416803367797339,
                    "affiliationType": "indirect owner"
                }
            ],
            "attestationStatus": null,
            "statutoryDisqualification": null,
            "registrations": [
                {
                    "regulatorCode": "ISE GEMX"
                },
                {
                    "regulatorCode": "LTSE"
                }
            ],
            "wasAssociatedWithDisciplinedFirmFlag": null,
            "finproAccountCreateDate": null,
            "finproUserFlag": "NO",
            "employments": [
                {
                    "firmCrdNumber": 3000005,
                    "isActive": "YES"
                }
            ],
            "attestationStatusTimestamp": null,
            "firstName": "Cristiona",
            "finproLastAccessDate": null,
            "statutoryDisqualificationCode": "Yes - Approval/Denial Pending",
            "otherBusiness": null,
            "middleName": null,
            "outsideBusinessFlag": "NO",
            "individualCrdNumber": 3
        },
        {
            "lastName": "Ashton",
            "investmentAdvisorAffiliations": [
                {
                    "affiliationFirmName": "vrlFPccczARzECCGMgqB",
                    "affiliationFirmCrdNumber": 6120935849927548528,
                    "affiliationType": "relying advisor control person"
                }
            ],
            "attestationStatus": null,
            "statutoryDisqualification": null,
            "registrations": [
                {
                    "regulatorCode": "NYSE-NAT"
                },
                {
                    "regulatorCode": "NYSE"
                }
            ],
            "wasAssociatedWithDisciplinedFirmFlag": null,
            "finproAccountCreateDate": null,
            "finproUserFlag": "NO",
            "employments": [
                {
                    "firmCrdNumber": 3000005,
                    "isActive": "YES"
                },
                {
                    "firmCrdNumber": 3000005,
                    "isActive": "YES"
                }
            ],
            "attestationStatusTimestamp": null,
            "firstName": "Auburn",
            "finproLastAccessDate": null,
            "statutoryDisqualificationCode": "Yes",
            "otherBusiness": null,
            "middleName": null,
            "outsideBusinessFlag": "NO",
            "individualCrdNumber": 4
        },
        {
            "lastName": "Pedroche",
            "investmentAdvisorAffiliations": [
                {
                    "affiliationFirmName": "xSedjZKLAOxXmGxUMyHl",
                    "affiliationFirmCrdNumber": -6063974753254122206,
                    "affiliationType": "relying advisor control person"
                }
            ],
            "attestationStatus": "Data Correct",
            "statutoryDisqualification": null,
            "registrations": [
                {
                    "regulatorCode": "WV"
                },
                {
                    "regulatorCode": "BX"
                }
            ],
            "wasAssociatedWithDisciplinedFirmFlag": null,
            "finproAccountCreateDate": "2020-06-17",
            "finproAttestations": [
                {
                    "attestationStatus": "Data Correct",
                    "attestationStatusTimestamp": "2021-07-14 18:07:04"
                },
                {
                    "attestationStatus": "Data Incorrect",
                    "attestationStatusTimestamp": "2021-07-14 17:07:04"
                }
            ],
            "finproUserFlag": "YES",
            "employments": [
                {
                    "firmCrdNumber": 3000005,
                    "isActive": "YES"
                }
            ],
            "attestationStatusTimestamp": "2021-07-14 18:07:04",
            "firstName": "Hebel",
            "finproLastAccessDate": "2021-01-22",
            "statutoryDisqualificationCode": null,
            "otherBusiness": null,
            "middleName": null,
            "outsideBusinessFlag": "NO",
            "individualCrdNumber": 5
        },
        {
            "lastName": "Vaquero",
            "investmentAdvisorAffiliations": [
                {
                    "affiliationFirmName": "ZMBLKYDsnLkSQRFQtuVO",
                    "affiliationFirmCrdNumber": 4998304539823487708,
                    "affiliationType": "relying advisor control person"
                }
            ],
            "attestationStatus": "Data Correct",
            "statutoryDisqualification": null,
            "registrations": [
                {
                    "regulatorCode": "NYSE-AMER"
                },
                {
                    "regulatorCode": "CBOE BYX"
                }
            ],
            "wasAssociatedWithDisciplinedFirmFlag": null,
            "finproAccountCreateDate": "2019-11-16",
            "finproAttestations": [
                {
                    "attestationStatus": "Data Correct",
                    "attestationStatusTimestamp": "2021-07-14 18:07:04"
                },
                {
                    "attestationStatus": "Data Incorrect",
                    "attestationStatusTimestamp": "2021-07-14 17:07:04"
                }
            ],
            "finproUserFlag": "YES",
            "employments": [
                {
                    "firmCrdNumber": 3000005,
                    "isActive": "YES"
                },
                {
                    "firmCrdNumber": 3000005,
                    "isActive": "YES"
                }
            ],
            "attestationStatusTimestamp": "2021-07-14 18:07:04",
            "firstName": "Aubert",
            "finproLastAccessDate": "2020-03-30",
            "statutoryDisqualificationCode": null,
            "otherBusiness": null,
            "middleName": "Schilling",
            "outsideBusinessFlag": "NO",
            "individualCrdNumber": 6
        },
        {
            "lastName": "Argaiz",
            "investmentAdvisorAffiliations": [
                {
                    "affiliationFirmName": "QPVVytYSxgnOHtHJTYJZ",
                    "affiliationFirmCrdNumber": 5917909857478129497,
                    "affiliationType": "direct owner"
                }
            ],
            "attestationStatus": null,
            "statutoryDisqualification": null,
            "registrations": [
                {
                    "regulatorCode": "NYSE-ARCA"
                },
                {
                    "regulatorCode": "BOX"
                }
            ],
            "wasAssociatedWithDisciplinedFirmFlag": null,
            "finproAccountCreateDate": null,
            "finproUserFlag": "NO",
            "employments": [
                {
                    "firmCrdNumber": 3000005,
                    "isActive": "YES"
                },
                {
                    "firmCrdNumber": 3000005,
                    "isActive": "YES"
                }
            ],
            "attestationStatusTimestamp": null,
            "firstName": "Madden",
            "finproLastAccessDate": null,
            "statutoryDisqualificationCode": null,
            "otherBusiness": null,
            "middleName": null,
            "outsideBusinessFlag": "NO",
            "individualCrdNumber": 7
        },
        {
            "lastName": "Inguanzo",
            "investmentAdvisorAffiliations": [
                {
                    "affiliationFirmName": "PBIMhXoEgYvXKtqiXNEd",
                    "affiliationFirmCrdNumber": 8142827401662318308,
                    "affiliationType": "relying advisor control person"
                }
            ],
            "attestationStatus": null,
            "statutoryDisqualification": null,
            "registrations": [
                {
                    "regulatorCode": "KY"
                },
                {
                    "regulatorCode": "CBOE C2"
                }
            ],
            "wasAssociatedWithDisciplinedFirmFlag": null,
            "finproAccountCreateDate": null,
            "finproUserFlag": "NO",
            "employments": [
                {
                    "firmCrdNumber": 3000005,
                    "isActive": "YES"
                }
            ],
            "attestationStatusTimestamp": null,
            "f