Check EOL

curl --location --request POST 'https://edb-prod.xeol.io/eol/check' \
--data-raw '{
  "component": {
      "name": "Go",
      "ecosystem": "generic",
      "version": "1.15"
  }
}'

{
  "error": null,
  "result": {
    "componentName": "Go",
    "ecosystem": "generic",
    "version": {
      "id": "cv_92UqG6FZu2uoxebKZs5bcEN8CFoqPGC6bx62kn4fzEwr",
      "version": "1.15",
      "componentId": "c_3qrajMUJoCZLzbYxCA6wxfo1W1nDPTLvr5PMJKuYiFks",
      "releasedAt": "2020-08-11T00:00:00.000Z",
      "createdAt": "2024-03-15T17:00:19.685Z",
      "updatedAt": "2024-03-15T17:00:19.685Z"
    },
    "eol": {
      "now": {
        "primary": {
          "reason": "vendor_announced",
          "date": "2021-08-16T00:00:00.000Z",
          "supportLevel": "STANDARD_SUPPORT",
          "isDefault": true
        },
        "other": []
      },
      "future": null
    },
    "lifecycles": [{
      "id": "life_Hukr1PH1ir9XMmDomzZ4j1hAurbWnJfTr4Hs6i4XZtkJ",
      "eolAt": "2021-08-16T00:00:00.000Z",
      "componentId": "c_3qrajMUJoCZLzbYxCA6wxfo1W1nDPTLvr5PMJKuYiFks",
      "range": "~1.15",
      "supportLevel": "STANDARD_SUPPORT",
      "isDefault": true,
      "uri": null,
      "eolField": "eolAt",
      "isEol": null,
      "componentVersionId": "cv_92UqG6FZu2uoxebKZs5bcEN8CFoqPGC6bx62kn4fzEwr",
      "lifecycleId": "life_Hukr1PH1ir9XMmDomzZ4j1hAurbWnJfTr4Hs6i4XZtkJ"
    }],
    "registry": null
  }
}

{
  "result": null,
  "error": {
    "message": "Json body validation failed: component.ecosystem: invalid enum value. expected 'generic' | 'npm' | 'nuget' | 'pypi' | 'maven' | 'golang', received ''"
  }
}

{
  "result": null,
  "error": {
    "message": "Unauthorized"
  }
}

POST

eol

check

curl --location --request POST 'https://edb-prod.xeol.io/eol/check' \
--data-raw '{
  "component": {
      "name": "Go",
      "ecosystem": "generic",
      "version": "1.15"
  }
}'

{
  "error": null,
  "result": {
    "componentName": "Go",
    "ecosystem": "generic",
    "version": {
      "id": "cv_92UqG6FZu2uoxebKZs5bcEN8CFoqPGC6bx62kn4fzEwr",
      "version": "1.15",
      "componentId": "c_3qrajMUJoCZLzbYxCA6wxfo1W1nDPTLvr5PMJKuYiFks",
      "releasedAt": "2020-08-11T00:00:00.000Z",
      "createdAt": "2024-03-15T17:00:19.685Z",
      "updatedAt": "2024-03-15T17:00:19.685Z"
    },
    "eol": {
      "now": {
        "primary": {
          "reason": "vendor_announced",
          "date": "2021-08-16T00:00:00.000Z",
          "supportLevel": "STANDARD_SUPPORT",
          "isDefault": true
        },
        "other": []
      },
      "future": null
    },
    "lifecycles": [{
      "id": "life_Hukr1PH1ir9XMmDomzZ4j1hAurbWnJfTr4Hs6i4XZtkJ",
      "eolAt": "2021-08-16T00:00:00.000Z",
      "componentId": "c_3qrajMUJoCZLzbYxCA6wxfo1W1nDPTLvr5PMJKuYiFks",
      "range": "~1.15",
      "supportLevel": "STANDARD_SUPPORT",
      "isDefault": true,
      "uri": null,
      "eolField": "eolAt",
      "isEol": null,
      "componentVersionId": "cv_92UqG6FZu2uoxebKZs5bcEN8CFoqPGC6bx62kn4fzEwr",
      "lifecycleId": "life_Hukr1PH1ir9XMmDomzZ4j1hAurbWnJfTr4Hs6i4XZtkJ"
    }],
    "registry": null
  }
}

{
  "result": null,
  "error": {
    "message": "Json body validation failed: component.ecosystem: invalid enum value. expected 'generic' | 'npm' | 'nuget' | 'pypi' | 'maven' | 'golang', received ''"
  }
}

{
  "result": null,
  "error": {
    "message": "Unauthorized"
  }
}

Body

component

object

required

An identifier to determine an entity’s EOL status. Only one of the following can be provided: cpe, purl, custom.

Show properties

name

string

required

The name of the software.

version

string

required

The software version.

ecosystem

string

required

The ecosystem that this software belongs to. Defaults to generic.

lifecycle

string

The field takes a support ID to match against. If not provided, it will default to STANDARD_SUPPORT which is the base level of support for any entity.STANDARD_SUPPORT is defined as the base support level in which security updates are provided for the entity.

Response

eol

boolean

Whether the matched entity is end-of-life.

eol_reason

string

The reason the entity was marked as deprecated. Can be one of VENDOR_ANNOUNCED, REGISTRY_DEPRECATED, or SOURCE_ARCHIVED.

eol_date

string

The end-of-life date for the matched entity.

match

object

Information about the match.

Show match

found

bool

Whether a match was found.

message

string

Information about why the match was not found.

found_support

boolean

Whether the entity support was found.

request

object

The request that triggered this response.

Show request

identifier

object

Entity identifier object for the request.

Show identifier

cpe

string

Common Platform Enumeration identifier

evidence

object

Evidence supporting the eol status.

Show evidence

schema_version

string

Schema version

string

Unique identifier

modified

datetime

Last modified date

published

datetime

Published date

entity

object

Matched entity info.

Show entity

lts

boolean

Whether the matched entity has Long Term Support

name

string

Name of the matched entity

released

datetime

Release date of the matched entity

type

string

Type of the matched entity. Will be one of: service, device, software, package, os.

vendor

string

Vendor of the matched entity

version

string

Version of the matched entity

support

object[]

The available support levels for the matched entity.

Show support

eol

datetime

End-of-life date

string

Support ID

level

integer

Support level

references

object[]

References are used to provide additional information about the matched entity.

Show references

type

string

Type of reference. Will be one of: CHANGELOG, ARTICLE, WEB, SOURCE, PACKAGE

url

string

URL of the reference

identification

object

Identification methods used.

Show identification

cpes

string[]

List of Common Platform Enumeration identifiers

custom

object

Custom identification

Show custom

name

string

Custom name

vendor

string

Custom vendor

purls

string[]

List of Package URL identifiers

versions

string[]

List of versions

curl --location --request POST 'https://edb-prod.xeol.io/eol/check' \
--data-raw '{
  "component": {
      "name": "Go",
      "ecosystem": "generic",
      "version": "1.15"
  }
}'

{
  "error": null,
  "result": {
    "componentName": "Go",
    "ecosystem": "generic",
    "version": {
      "id": "cv_92UqG6FZu2uoxebKZs5bcEN8CFoqPGC6bx62kn4fzEwr",
      "version": "1.15",
      "componentId": "c_3qrajMUJoCZLzbYxCA6wxfo1W1nDPTLvr5PMJKuYiFks",
      "releasedAt": "2020-08-11T00:00:00.000Z",
      "createdAt": "2024-03-15T17:00:19.685Z",
      "updatedAt": "2024-03-15T17:00:19.685Z"
    },
    "eol": {
      "now": {
        "primary": {
          "reason": "vendor_announced",
          "date": "2021-08-16T00:00:00.000Z",
          "supportLevel": "STANDARD_SUPPORT",
          "isDefault": true
        },
        "other": []
      },
      "future": null
    },
    "lifecycles": [{
      "id": "life_Hukr1PH1ir9XMmDomzZ4j1hAurbWnJfTr4Hs6i4XZtkJ",
      "eolAt": "2021-08-16T00:00:00.000Z",
      "componentId": "c_3qrajMUJoCZLzbYxCA6wxfo1W1nDPTLvr5PMJKuYiFks",
      "range": "~1.15",
      "supportLevel": "STANDARD_SUPPORT",
      "isDefault": true,
      "uri": null,
      "eolField": "eolAt",
      "isEol": null,
      "componentVersionId": "cv_92UqG6FZu2uoxebKZs5bcEN8CFoqPGC6bx62kn4fzEwr",
      "lifecycleId": "life_Hukr1PH1ir9XMmDomzZ4j1hAurbWnJfTr4Hs6i4XZtkJ"
    }],
    "registry": null
  }
}

{
  "result": null,
  "error": {
    "message": "Json body validation failed: component.ecosystem: invalid enum value. expected 'generic' | 'npm' | 'nuget' | 'pypi' | 'maven' | 'golang', received ''"
  }
}

{
  "result": null,
  "error": {
    "message": "Unauthorized"
  }
}

EOL Database

API

Architecture

Body

Response

​Body

​Response

Body

Response