My Developer Portal
LaborLens API

Endpoint:https://laborlens-main-ffad08a.zuplo.app

Search (Sponsor)

POST
https://laborlens-main-ffad08a.zuplo.app
/search

This endpoint allows you to search for plan sponsors using various filters and criteria. You can:

  • Text search: Use the 'query' parameter to search sponsor names and other text fields
  • Filter by company size: Set minimum/maximum participant counts (total or active participants) to find sponsors within specific size ranges
  • Filter by industry: Use industry classifications to find sponsors in specific sectors
  • Target specific sponsors: Search by exact sponsor IDs if known

Results include all available sponsor information, participant statistics, asset amounts, and industry classifications. Use pagination with the 'start' parameter for large result sets. This endpoint is ideal for market research, competitor analysis, or identifying sponsors that meet specific criteria.

Search (Sponsor) › Headers

  • Authorizationstring · required

    The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Search (Sponsor) › Request Body

  • startinteger | null
  • querystring | null
  • sponsor_idsstring[]
  • industriesstring[]
  • min_total_participantsinteger | null
  • max_total_participantsinteger | null
  • min_active_participantsinteger | null
  • max_active_participantsinteger | null

Search (Sponsor) › Responses

Successful search response

  • countinteger
  • resultsobject[]

Industries

GET
https://laborlens-main-ffad08a.zuplo.app
/industries

This endpoint returns a comprehensive list of all available industry classification codes that can be used for filtering in sponsor searches. The response includes:

  • Industry codes: Unique numerical identifiers for each industry classification
  • Hierarchical structure: Three levels of industry detail from broad sectors to specific sub-industries
    • Level 1: Major industry sectors (e.g., "Agriculture, Forestry, Fishing and Hunting")
    • Level 2: Industry groups within sectors (e.g., "Animal Production")
    • Level 3: Specific industry classifications (e.g., "Cattle Feedlots")

Use this endpoint to discover available industry filter options before making sponsor search requests. The industry codes and names returned can be used directly in the sponsor search endpoint's 'industries' filter parameter. This is essential for building industry-based search interfaces or understanding the scope of available industry classifications in the dataset.

Industries › Headers

  • Authorizationstring · required

    The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Industries › Responses

A list of industry classifications.

  • codestring · required

    Unique numerical identifier for the industry classification

  • industry_level_onestring · required

    Top-level industry sector (e.g., 'Agriculture, Forestry, Fishing and Hunting')

  • industry_level_twostring · required

    Second-level industry group within the sector (e.g., 'Animal Production')

  • industry_level_threestring · required

    Most specific industry classification (e.g., 'Cattle Feedlots')

GET
https://laborlens-main-ffad08a.zuplo.app
/sponsor/{sponsor_id}

This endpoint returns detailed information about a plan sponsor (the company that offers employee benefit plans) including:

  • Sponsor details (company information)
  • All plans administered by the sponsor (401k, health insurance, etc.)
  • Complete filing history and regulatory data for all plans

Use this endpoint when you need a complete overview of a sponsor's benefit program and compliance records.

Sponsor › Headers

  • Authorizationstring · required

    The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Sponsor › Responses

Successful sponsor response

  • sponsorobject
  • plansobject[]

Filing

GET
https://laborlens-main-ffad08a.zuplo.app
/filing/{ack_id}

This endpoint returns detailed information for a single filing record using its unique filing ID. Each filing contains:

  • Filing metadata (submission date, filing year, status)
  • Associated sponsor information (company details)
  • Specific plan details for the filing year
  • Complete regulatory data and compliance information

Note: Each plan requires annual filings, so a sponsor with multiple plans will have separate filing records for each plan per year. Use this endpoint when you need detailed information about a specific filing submission rather than all filings for a sponsor.

Filing › Headers

  • Authorizationstring · required

    The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Filing › Responses

Successful filing response

  • sponsor_namestring · required

    Official name of the plan sponsor

  • sponsor_einstring · required

    Employer Identification Number (EIN) of the sponsor

  • sponsor_phone_numberstring · required

    Primary contact phone number for the sponsor

  • sponsor_business_codestring · required

    Business classification code for the sponsor's primary business activity

  • sponsor_address1string · required

    Primary address line of the sponsor's headquarters

  • sponsor_citystring · required

    City where the sponsor is headquartered

  • sponsor_statestring · required

    State or province where the sponsor is headquartered

  • sponsor_postal_codestring · required

    ZIP or postal code for the sponsor's headquarters

  • sponsor_countrystring · required

    Country where the sponsor is headquartered

  • ack_idstring · required

    Unique acknowledgment ID for the filing submission

  • form_yearinteger · required

    Year for which the form is being filed

  • cy_fy_begin_datestring · date · required

    Beginning date of the plan year covered by this filing (ISO 8601 date format)

  • cy_fy_end_datestring · date · required

    End date of the plan year covered by this filing (ISO 8601 date format)

  • plan_namestring · required

    Official name of the employee benefit plan

  • plan_numstring · required

    Plan number assigned by the sponsor (typically 3-digit identifier)

  • plan_effective_datestring · date · required

    Date when the plan became effective (ISO 8601 date format)

  • pension_benefit_codesstring[] · required

    Array of pension benefit codes indicating the types of pension benefits offered

  • date_receivedstring · date · required

    Date when the filing was received by the regulatory authority (ISO 8601 date format)

  • total_participants_beginning_of_yearinteger · required

    Total number of participants at the beginning of the plan year

  • total_participants_end_of_yearinteger · required

    Total number of participants at the end of the plan year

  • participants_with_account_balances_end_of_yearinteger · required

    Number of participants with account balances at the end of the plan year

  • active_participants_beginning_of_yearinteger · required

    Number of active participants at the beginning of the plan year

  • active_participants_end_of_yearinteger · required

    Number of active participants at the end of the plan year

  • participants_teminated_before_vestinginteger · required

    Number of participants who terminated before vesting

  • type_plan_entity_cdstring · required

    Code indicating the type of plan entity

  • tot_assets_boy_amtnumber · required

    Total assets at the beginning of the year (in USD)

  • tot_assets_eoy_amtnumber · required

    Total assets at the end of the year (in USD)

  • tot_liabilities_boy_amtnumber · required

    Total liabilities at the beginning of the year (in USD)

  • tot_liabilities_eoy_amtnumber · required

    Total liabilities at the end of the year (in USD)

  • net_assets_boy_amtnumber · required

    Net assets at the beginning of the year (in USD)

  • net_assets_eoy_amtnumber · required

    Net assets at the end of the year (in USD)

  • emplr_contrib_income_amtnumber · required

    Employer contribution income amount for the plan year (in USD)

  • particip_contrib_income_amtnumber · required

    Participant contribution income amount for the plan year (in USD)

  • oth_contrib_rcvd_amtnumber · required

    Other contributions received amount for the plan year (in USD)

  • other_income_amtnumber · required

    Other income amount for the plan year (in USD)

  • tot_income_amtnumber · required

    Total income amount for the plan year (in USD)

  • tot_distrib_bnft_amtnumber · required

    Total distribution benefit amount for the plan year (in USD)

  • corrective_deemed_distr_amtnumber · required

    Corrective deemed distribution amount for the plan year (in USD)

  • admin_srvc_providers_amtnumber · required

    Administrative service providers amount for the plan year (in USD)

  • oth_expenses_amtnumber · required

    Other expenses amount for the plan year (in USD)

  • tot_expenses_amtnumber · required

    Total expenses amount for the plan year (in USD)

  • net_income_amtnumber · required

    Net income amount for the plan year (in USD)

  • tot_plan_transfers_amtnumber · required

    Total plan transfers amount for the plan year (in USD)

  • created_atstring · date-time · required

    Timestamp when the filing record was created (ISO 8601 format)

  • updated_atstring · date-time · required

    Timestamp when the filing record was last updated (ISO 8601 format)

  • last_reported_sponsor_namestring | null

    Previously reported sponsor name if different from current

  • last_reported_sponsor_einstring | null

    Previously reported sponsor EIN if different from current

  • sponsor_address2string | null

    Secondary address line (suite, floor, etc.) of the sponsor's headquarters

  • last_reported_plan_namestring | null

    Previously reported plan name if different from current

  • last_reported_plan_numberstring | null

    Previously reported plan number if different from current

  • welfare_benefit_codesarray | null

    Array of welfare benefit codes indicating the types of welfare benefits offered

  • broker_fees_paidnumber | null

    Amount of broker fees paid during the plan year (in USD)

  • insuranceobject[]