Skip to main content
GET
/
issues
/
by_number
/
{number}
JavaScript
import Antimetal from '@antimetal/sdk';

const client = new Antimetal({
  apiKey: process.env['ANTIMETAL_API_KEY'], // This is the default and can be omitted
});

const issue = await client.issues.retrieveByNumber(123);

console.log(issue.uuid);
{
  "uuid": "<string>",
  "number": 4503599627370495,
  "title": "<string>",
  "description": "<string>",
  "severity": "low",
  "status": "investigating",
  "environment": "<string>",
  "triggeredAt": "2023-11-07T05:31:56Z",
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "seedCount": 4503599627370495,
  "seeds": [
    {
      "publicUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "seedType": "alert",
      "provider": "datadog",
      "providerReferenceId": "<string>",
      "title": "<string>",
      "description": "<string>",
      "tags": [
        "<string>"
      ],
      "triggeredAt": "2023-11-07T05:31:56Z",
      "link": "<string>",
      "query": "<string>",
      "rawPayload": {}
    }
  ],
  "latestVersion": 4503599627370496,
  "versions": [
    {
      "uuid": "<string>",
      "version": 4503599627370496,
      "status": "SUCCESS",
      "description": "<string>"
    }
  ]
}

Authorizations

Authorization
string
header
required

API key authentication via Bearer token

Headers

Antimetal-Version
string
default:2026-03-17

The API version to use. Defaults to the latest stable version if omitted. Pin to the version string in this document's info.version field to opt into exactly this version's schema.

Example:

"2026-03-17"

Path Parameters

number
integer<int32>
required

Issue number (organization-scoped)

Required range: x >= 1
Example:

123

Response

Issue details

uuid
string
required

Issue unique identifier

number
integer
required

Issue number (scoped per-organization)

Required range: 0 < x <= 9007199254740991
title
string
required

Issue title

description
string
required

Issue description

severity
enum<string>
required

Issue severity level

Available options:
low,
medium,
high
status
enum<string>
required

Current issue status

Available options:
investigating,
ready_to_fix,
resolved,
muted
environment
string
required

Environment where issue occurred

triggeredAt
string<date-time>
required

Earliest trigger time from seeds

Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
createdAt
string<date-time>
required

Date and time the issue was created

Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
updatedAt
string<date-time>
required

Date and time the issue was last updated

Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
seedCount
integer
required

Number of seeds for this issue

Required range: 0 <= x <= 9007199254740991
seeds
object[]
required

Seeds associated with the issue

latestVersion
integer
required

Most recent version of this issue

Required range: 1 <= x <= 9007199254740991
versions
object[]
required

Available versions of the issue