Skip to content
English
Contact us
  • There are no suggestions because the search field is empty.

How to Retrieve a Data Tag

Data Tags are standardized identifiers used throughout the Intrinio API to represent individual financial metrics, such as revenue, net income, EBITDA, or earnings per share. When working with company fundamentals, Data Tags allow you to request specific financial values in a consistent and predictable way.

This article explains how to retrieve available Data Tags and how to look up information for a specific tag.

Retrieve All Data Tags

To retrieve a complete list of available Data Tags, use the All Data Tags endpoint.

Endpoint

GET /data_tags

This endpoint returns all available Data Tags along with information such as:

  • Tag name
  • Human-readable label
  • Description
  • Data type
  • Statement classification (when applicable)

You can use this endpoint to browse the available financial metrics before requesting company fundamentals.

Search for a Data Tag

If you know part of a Data Tag's name or description, use the Search Data Tags endpoint.

Endpoint

GET /data_tags/search

This endpoint lets you quickly locate a Data Tag without downloading the entire list.

Example use cases include searching for:

  • Revenue
  • Operating Income
  • Free Cash Flow
  • Earnings Per Share

Retrieve a Specific Data Tag

Once you know the ID of a Data Tag, you can retrieve its full details.

Endpoint

GET /data_tags/{identifier}

Replace {identifier} with the Data Tag's unique identifier.

Example:

GET /data_tags/revenue

The response includes metadata describing the Data Tag, making it easier to understand exactly what financial metric it represents.

Common Workflow

A typical workflow looks like this:

  1. Retrieve all Data Tags or search for the one you need.
  2. Identify the desired Data Tag.
  3. Use that Data Tag when requesting company fundamentals or financial data from the appropriate API endpoints.

This approach ensures you're using the correct standardized metric across companies and reporting periods.

AI-Assisted Development

If you're building an application with Intrinio, we recommend using the Intrinio MCP Server. The MCP server is aware of your Intrinio subscription and can recommend the best datasets, endpoints, and tools that your account already has access to, helping reduce implementation errors and avoid unavailable resources.

Learn more:

For implementation details—including endpoint parameters, request schemas, response formats, and examples—refer to the Intrinio OpenAPI specification, which is the preferred source of truth for developers and AI coding assistants.

OpenAPI documentation: