---
title: "Look up a company by its trading symbol (ticker)."
url: "https://developer.argaam.com/apis/market-data-layer-api-sandbox-v1/versions/76611d79-bb1b-44da-aed6-aca8b510fd74/operations/getCompaniesBySymbolBySymbol"
---

> Full API specification: https://developer.argaam.com/apis/market-data-layer-api-sandbox-v1/versions/76611d79-bb1b-44da-aed6-aca8b510fd74.md

# Look up a company by its trading symbol (ticker).

`GET` `/api/v1.1/companies/by-symbol/{symbol}`

Operation ID: `getCompaniesBySymbolBySymbol`

Resolves a ticker symbol to the full company profile. Useful for building widgets where the user types in a symbol (e.g. `2222`, `SABIC`) and you need the canonical company ID and metadata. The symbol match is **case-insensitive**. Returns `404` when no company with the given symbol is found. **Tip:** For shareholders by symbol use `GET /companies/by-symbol/{symbol}/shareholders`. For analyst estimates by symbol use `GET /companies/by-symbol/{symbol}/analyst-estimates`.

## Path parameters

- `symbol` (string, required) - Company ticker symbol, e.g. `2222`. Equivalent to `stockSymbol` on other endpoints.

## Query parameters

- `marketId` (integer, int32, optional) - Numeric market identifier (e.g. `1` = Tadawul / Saudi main market). Use `GET /api/v1.1/markets` to list valid values. Defaults to `3`.

## Responses

- `200` - Success

## OpenAPI definition

```yaml
openapi: 3.0.1
info:
  title: Market Data Layer API
  version: v1.1
servers:
  - url: https://api-sandbox.argaam.com
    description: Argaam API Gateway (Sandbox)
paths:
  /api/v1.1/companies/by-symbol/{symbol}:
    get:
      tags:
        - Companies
      parameters:
        - name: symbol
          in: path
          required: true
          schema:
            type: string
          description: Company ticker symbol, e.g. `2222`. Equivalent to `stockSymbol` on
            other endpoints.
        - name: marketId
          in: query
          schema:
            type: integer
            format: int32
            default: 3
          example: 3
          description: Numeric market identifier (e.g. `1` = Tadawul / Saudi main market).
            Use `GET /api/v1.1/markets` to list valid values. Defaults to `3`.
      responses:
        "200":
          description: Success
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiV1Response"
      summary: Look up a company by its trading symbol (ticker).
      description: "Resolves a ticker symbol to the full company profile. Useful for\r

        building widgets where the user types in a symbol (e.g. `2222`,\r

        `SABIC`) and you need the canonical company ID and metadata.\r

        \            \r

        The symbol match is **case-insensitive**.\r

        \            \r

        Returns `404` when no company with the given symbol is found.\r

        \            \r

        **Tip:** For shareholders by symbol use\r

        `GET /companies/by-symbol/{symbol}/shareholders`.\r

        For analyst estimates by symbol use\r

        `GET /companies/by-symbol/{symbol}/analyst-estimates`."
      operationId: getCompaniesBySymbolBySymbol
security:
  - ApiKeyAuth: []
components:
  schemas:
    ApiV1Response:
      type: object
      properties:
        success:
          type: boolean
        apiVersion:
          type: string
          nullable: true
        timestamp:
          type: string
          format: date-time
        requestId:
          type: string
          nullable: true
        data:
          nullable: true
        meta:
          $ref: "#/components/schemas/ApiV1Meta"
        rateLimit:
          $ref: "#/components/schemas/ApiV1RateLimit"
      additionalProperties: false
    ApiV1Meta:
      type: object
      properties:
        page:
          type: integer
          format: int32
        pageSize:
          type: integer
          format: int32
        totalRecords:
          type: integer
          format: int32
        totalPages:
          type: integer
          format: int32
          readOnly: true
        hasNextPage:
          type: boolean
          readOnly: true
        hasPreviousPage:
          type: boolean
          readOnly: true
      additionalProperties: false
    ApiV1RateLimit:
      type: object
      properties:
        limit:
          type: integer
          format: int32
        remaining:
          type: integer
          format: int32
        reset:
          type: string
          format: date-time
      additionalProperties: false
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: apikey
```