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

# ASN Lookup

> This API method allows you to look up any given Autonomous System Number (ASN) and retrieve comprehensive data associated with it.

The information returned includes the ASN name, organization name, country, associated domain, contact email, phone number, and more. This functionality is essential for network analysis, troubleshooting, and understanding the infrastructure behind IP addresses.

export const MCPCallout = () => {
  return <div class="callout my-4 px-5 py-4 overflow-hidden rounded-2xl flex gap-3 border border-[rgba(192, 132, 252, 0.2)] bg-[rgba(192, 132, 252, 0.1)] dark:border-[#c084fc4d] dark:bg-[#c084fc1a] text-[#6005BB] dark:text-[#FFFFFF]" data-callout-type="callout">
      <div class="mt-0.5 w-4" data-component-part="callout-icon">
        <svg class="h-4 w-4 !m-0 shrink-0 bg-[#c084fc] [mask-image:url('https://d3gk2c5xim1je2.cloudfront.net/v7.1.0/duotone/fire.svg')] [-webkit-mask-image:url('https://d3gk2c5xim1je2.cloudfront.net/v7.1.0/duotone/fire.svg')] [mask-repeat:no-repeat] [-webkit-mask-repeat:no-repeat] [mask-position:center] [-webkit-mask-position:center]"></svg>
      </div>
      <div class="text-sm prose dark:prose-invert min-w-0 w-full [&_kbd]:bg-background-light dark:[&_kbd]:bg-background-dark text-[#6005BB] dark:text-[#FFFFFF]" data-component-part="callout-content">
        <span data-as="p">
          Want to skip the docs? Use the{" "}
          <a class="link mint-text-xs border-[#C792FC]" href="/docs-mcp-server">
            <b>MCP Server</b>
          </a>
        </span>
      </div>
    </div>;
};

export const Availability = ({plan, color}) => {
  const colorMap = {
    green: "text-green-700 dark:text-green-400",
    blue: "text-blue-700 dark:text-blue-400",
    purple: "text-purple-700 dark:text-purple-400"
  };
  return <div dir="ltr" data-orientation="horizontal" class="p-4 px-5 mt-0 md:mt-4 flex flex-col sm:flex-row flex-wrap gap-2 relative overflow-hidden rounded-2xl border border-gray-950/10 dark:border-white/10 my-0 bg-gray-50 dark:bg-white/5 dark:codeblock-dark text-gray-950 dark:text-gray-50 codeblock-light text-sm prose prose-gray dark:prose-invert font-semibold no-wrap-words">
      Endpoint availability:{" "}
      <span class={` ${colorMap[color]} flex-1`}>{plan}</span>
      <a class="custom-link text-xs" href="https://greip.io/detailed-pricing">
        Learn more
      </a>
    </div>;
};

### Query Parameters

<ParamField query="asn" type="string" placeholder="IP address" required>
  The asn command is used to specify the AS Number you want to lookup.

  Sample value: `AS6167` or `6167`
</ParamField>

<ParamField query="format" type="string" default="JSON" placeholder="Response format">
  The format command is used to get a response in a specific format.

  Expected values: `JSON`, `XML`, `CSV`, or `Newline`

  For more information please refer to [Response Format](/options/response-format).
</ParamField>

<ParamField query="mode" type="string" default="live" placeholder="Environment">
  The mode command is used to in the development stage to simulate the integration process before releasing it to the production environment.

  Expected values: `live`, or `test`.

  For more information please refer to [Development Environment](/options/development-environment).
</ParamField>

<ParamField query="callback" type="string" placeholder="JSONP callback">
  The callback command can help you make the response as a JSONP format.

  Expected values: any name that can be used as a function name in Javascript, e.g: `myFunctionName`.

  For more information please refer to [JSONP Callback](/options/jsonp-callback).
</ParamField>

<Panel>
  <MCPCallout />

  <Availability plan="Premium and above" color="purple" />

  <ResponseExample>
    ```json Success theme={null}
    {
      "data": {
        "asn": "AS9112",
        "name": "POZMAN",
        "country": "PL",
        "org": "Institute of Bioorganic Chemistry Polish Academy of Science, Poznan Supercomputing and Networking Center",
        "phone": "+48 61 8582010",
        "email": null,
        "domain": "poznan.pl",
        "status": "ASSIGNED",
        "created": "2004-04-17T11:47:57Z",
        "type": "education",
        "registry": "RIPE",
        "prefixes": {
          "ipv4": ["150.254.0.0/16", "62.3.160.0/19"],
          "ipv6": ["2001:808::/35"],
          "total": 3
        }
      },
      "status": "success",
      "executionTime": 0
    }
    ```

    ```json Error theme={null}
    {
      "status": "error",
      "code": 101,
      "type": "invalid_key",
      "description": "The API Key is missing or invalid."
    }
    ```
  </ResponseExample>
</Panel>

### Response properties

<ResponseField name="data" type="object" required>
  <Expandable title="properties" defaultOpen={true}>
    <ResponseField name="asn" type="string" required>
      Autonomous System Number you're looking up.
    </ResponseField>

    <ResponseField name="name" type="string" required>
      Name of the organization.
    </ResponseField>

    <ResponseField name="country" type="string" required>
      Country code of the organization.
    </ResponseField>

    <ResponseField name="org" type="string" required>
      Organization name.
    </ResponseField>

    <ResponseField name="phone" type="string" required>
      Phone number contact for the organization.
    </ResponseField>

    <ResponseField name="email" type="string" required>
      Email contact for the organization.
    </ResponseField>

    <ResponseField name="domain" type="string" required>
      Domain associated with the organization.
    </ResponseField>

    <ResponseField name="status" type="string" required>
      Status of the organization.
    </ResponseField>

    <ResponseField name="created" type="string" required>
      Date of organization creation.
    </ResponseField>

    <ResponseField name="type" type="string" required>
      Type of organization ("isp", "hosting", "business", "education", or
      "government").
    </ResponseField>

    <ResponseField name="registry" type="string" required>
      Registration information of the organization.
    </ResponseField>

    <ResponseField name="prefixes" type="object" required>
      <Expandable title="properties" defaultOpen={true}>
        <ResponseField name="ipv4" type="array" required>
          List of IPv4 prefixes associated with the organization.
        </ResponseField>

        <ResponseField name="ipv6" type="array" required>
          List of IPv6 prefixes associated with the organization.
        </ResponseField>

        <ResponseField name="total" type="integer" required>
          Total number of prefixes associated with the organization.
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="status" type="string" required>
  Response status (`success`, or `error`).
</ResponseField>

<ResponseField name="executionTime" type="integer" required>
  Time taken to process the data (in milliseconds).
</ResponseField>