> ## Documentation Index
> Fetch the complete documentation index at: https://docs.arrays.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Stock Basic Info Screener by Country

> [OpenAPI JSON Spec](/docs/output/v1_stocks_screener_basic-info_country_get.json)
Retrieve a list of stock companies filtered by country. Returns basic company information including ticker, name, sector, industry, exchange, and country.

**Country Codes**
Supports ISO 3166-1 alpha-2 country codes. 57 countries are supported:
- AE (United Arab Emirates), AR (Argentina), AU (Australia), BE (Belgium), BM (Bermuda), BR (Brazil), BS (Bahamas), CA (Canada), CH (Switzerland), CI (Côte d'Ivoire), CL (Chile), CN (China), CO (Colombia), CR (Costa Rica), CY (Cyprus), DE (Germany), DK (Denmark), ES (Spain), FI (Finland), FR (France), GB (United Kingdom), GG (Guernsey), GI (Gibraltar), GR (Greece), HK (Hong Kong), ID (Indonesia), IE (Ireland), IL (Israel), IN (India), IS (Iceland), IT (Italy), JE (Jersey), JO (Jordan), JP (Japan), KR (South Korea), KY (Cayman Islands), KZ (Kazakhstan), LU (Luxembourg), MC (Monaco), MO (Macao), MX (Mexico), MY (Malaysia), NL (Netherlands), NO (Norway), PA (Panama), PE (Peru), PH (Philippines), SE (Sweden), SG (Singapore), TH (Thailand), TR (Turkey), TW (Taiwan), US (United States), UY (Uruguay), VG (British Virgin Islands), VN (Vietnam), ZA (South Africa).
**ETF filter**: results default to non-ETF stocks (symbol_type=stock). Pass symbol_type=etf to return ETFs (e.g. SPY, QQQ).



## OpenAPI

````yaml /api-reference/openapi.json get /v1/stocks/screener/basic-info/country
openapi: 3.0.0
info:
  contact: {}
  description: >-
    Welcome to Arrays!


    Arrays is a unified financial data layer for both financial institutions and
    retail users, delivering comprehensive market data across crypto and equity
    markets. Our datasets cover fundamentals, ETFs, options, crypto, and more.


    Visit [arrays.org](https://arrays.org) to request an API key and start your
    free trial. You can explore our full API offerings in the documentation
    below.


    For any questions regarding APIs or pricing, please contact
    support@arrays.org.
  title: Arrays API
  version: '1.0'
servers:
  - url: https://data-tools.prd.arrays.org/api
security: []
paths:
  /v1/stocks/screener/basic-info/country:
    get:
      tags:
        - Stock
      summary: Get Stock Basic Info Screener by Country
      description: >-
        [OpenAPI JSON
        Spec](/docs/output/v1_stocks_screener_basic-info_country_get.json)

        Retrieve a list of stock companies filtered by country. Returns basic
        company information including ticker, name, sector, industry, exchange,
        and country.


        **Country Codes**

        Supports ISO 3166-1 alpha-2 country codes. 57 countries are supported:

        - AE (United Arab Emirates), AR (Argentina), AU (Australia), BE
        (Belgium), BM (Bermuda), BR (Brazil), BS (Bahamas), CA (Canada), CH
        (Switzerland), CI (Côte d'Ivoire), CL (Chile), CN (China), CO
        (Colombia), CR (Costa Rica), CY (Cyprus), DE (Germany), DK (Denmark), ES
        (Spain), FI (Finland), FR (France), GB (United Kingdom), GG (Guernsey),
        GI (Gibraltar), GR (Greece), HK (Hong Kong), ID (Indonesia), IE
        (Ireland), IL (Israel), IN (India), IS (Iceland), IT (Italy), JE
        (Jersey), JO (Jordan), JP (Japan), KR (South Korea), KY (Cayman
        Islands), KZ (Kazakhstan), LU (Luxembourg), MC (Monaco), MO (Macao), MX
        (Mexico), MY (Malaysia), NL (Netherlands), NO (Norway), PA (Panama), PE
        (Peru), PH (Philippines), SE (Sweden), SG (Singapore), TH (Thailand), TR
        (Turkey), TW (Taiwan), US (United States), UY (Uruguay), VG (British
        Virgin Islands), VN (Vietnam), ZA (South Africa).

        **ETF filter**: results default to non-ETF stocks (symbol_type=stock).
        Pass symbol_type=etf to return ETFs (e.g. SPY, QQQ).
      parameters:
        - description: Country code (ISO 3166-1 alpha-2)
          in: query
          name: country
          required: true
          schema:
            type: string
            enum:
              - AE
              - AR
              - AU
              - BE
              - BM
              - BR
              - BS
              - CA
              - CH
              - CI
              - CL
              - CN
              - CO
              - CR
              - CY
              - DE
              - DK
              - ES
              - FI
              - FR
              - GB
              - GG
              - GI
              - GR
              - HK
              - ID
              - IE
              - IL
              - IN
              - IS
              - IT
              - JE
              - JO
              - JP
              - KR
              - KY
              - KZ
              - LU
              - MC
              - MO
              - MX
              - MY
              - NL
              - 'NO'
              - PA
              - PE
              - PH
              - SE
              - SG
              - TH
              - TR
              - TW
              - US
              - UY
              - VG
              - VN
              - ZA
        - description: >-
            Asset type filter. Valid values: stock (non-ETF), etf. Optional,
            defaults to stock.
          in: query
          name: symbol_type
          schema:
            type: string
            enum:
              - stock
              - etf
      responses:
        '200':
          description: Successfully retrieved stock basic info by country
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/model.APIResponse'
                  - properties:
                      data:
                        items:
                          $ref: '#/components/schemas/model.StockScreenerItem'
                        type: array
                    type: object
        '400':
          description: Invalid parameters
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/model.APIResponse'
                  - properties:
                      error:
                        $ref: '#/components/schemas/model.APIError'
                    type: object
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/model.APIResponse'
                  - properties:
                      error:
                        $ref: '#/components/schemas/model.APIError'
                    type: object
      security:
        - ApiKeyAuth: []
components:
  schemas:
    model.APIResponse:
      properties:
        data: {}
        error:
          $ref: '#/components/schemas/model.APIError'
        metadata: {}
        pagination: {}
        request_id:
          type: string
        success:
          type: boolean
      type: object
    model.StockScreenerItem:
      properties:
        symbol:
          description: Stock symbol (e.g., AAPL)
          type: string
        type:
          description: 'Screener filter type: sector, industry, country, exchange'
          type: string
        value:
          description: Filter value matching the query parameter
          type: string
      type: object
    model.APIError:
      properties:
        code:
          example: RESOURCE_NOT_FOUND
          type: string
        details:
          items:
            $ref: '#/components/schemas/model.APIErrorDetail'
          type: array
        docs_url:
          type: string
        examples:
          items:
            type: string
          type: array
        hint:
          type: string
        message:
          example: The requested resource was not found.
          type: string
        suggestions:
          items:
            type: string
          type: array
      type: object
    model.APIErrorDetail:
      properties:
        field:
          type: string
        got:
          type: string
        reason:
          type: string
      type: object
  securitySchemes:
    ApiKeyAuth:
      description: 'API Key authentication. Example: "your-api-key-here"'
      in: header
      name: X-API-Key
      type: apiKey

````