ID Converter alias 'converter.tools.dedns.org' is closing it's doors, forever.
All related services will reach their end of life in December 2023.
At the end of the year all services will be discontinued.
With the release of our API endpoint v4, all previously deprecated endpoints have been discontinued.
It's not possible any longer to receive a valid response sending requests to v3 or earlier.
Requests still being sent to 'converter.api.dedns.org' will be responded with an error.
Due to compatibility issues and the reset of all API tokens, you will receive a 409 Gone.
For security reasons you are required to register a new account here to generate a new API token.

Getting started

This API allows you to lookup and check any existing Steam account.
Get access to public details about the target such as it's profile name, status, the creation date etc.
Furthermore bans of the Steam account issued by Valve or BattlEye can be determined.
Additionally the requested value will be converted to any sort of unique IDs you're also able to lookup.

Endpoint

https://api.id-converter.org/
Version 4
Request method GET

Authentication

Generating an API token requires to register an account
Account registrations are free, uncomplicated and done in seconds
An authentication at this endpoint is not necessarily required.
The response for unauthorized requests will only include ID conversions.
Requesting details of Steam accounts and known friends does require an authentication.
To authenticate a request provide your API token in the HTTP header or as GET parameter.


  • HTTP header

    {
        "Authorization": "api-token"
    }
  • GET parameter

    https://api.id-converter.org/76561197960265729?api-key=api-token
    Both
    api-key
    and
    api_key
    are valid parameter names to provide your API token.

Requests

A request can be made by adding the value to lookup to the request URI.
Details about a Steam account, e.g. bans or known friends requires to use GET parameters.


  • Request schema

    URL schema
    https://api.id-converter.org/value-to-convert-lookup

    Possible values Steam URL Steam Vanity URL Steam Invite URL Steam ID Hex Steam ID 64 Steam ID 3 Steam ID BattlEye ID Bohemia ID

    You can pass an entire URL, for example a Steam URL as value to the request URI.
    Various examples of requests including how to determine details can be found below.

    Passed values should never be URL encoded.
  • Optional parameters

    These GET parameters can be used to get details of the Steam account and known friends.
    details
    used to provide public profile details of the Steam account
    bans
    used to provide details of bans of the Steam account
    friends
    used to provide details of known friends of the Steam account

    Both GET parameters bans and friends do require the GET parameter details.

    Examples
    curl -X GET "https://api.id-converter.org/76561197960265729?details&api-key=api-token" \
    -H "Content-Type: application/json"
    (includes details about the Steam account; does not include ban checks or known friends)
    curl -X GET "https://api.id-converter.org/STEAM_0:1:0?details&bans&api-key=api-token" \
    -H "Content-Type: application/json"
    (includes details about the Steam account and ban checks; does not include known friends)
    curl -X GET "https://api.id-converter.org/[U:1:1]?details&bans&friends&api-key=api-token" \
    -H "Content-Type: application/json"
    (includes details about the Steam account, ban checks and known friends)
  • Unauthorized requests

    Examples
    • curl -X GET "https://api.id-converter.org/https://steam.../profiles/76561197960265729" \
      -H "Content-Type: application/json"
      curl -X GET "https://api.id-converter.org/steamcommunity.com/id/vanity-id" \
      -H "Content-Type: application/json"
    • {
          "error": false,
          "data": {
              "steam_url": "https://steamcommunity.com/profiles/76561197960265729",
              "steam_id_hex": "110000100000001",
              "steam_id64": "76561197960265729",
              "steam_id3": "[U:1:1]",
              "steam_id": "STEAM_0:1:0",
              "battleye_id": "74ae012b5407e0a3cc2cd82ec1f8ba7d",
              "bohemia_id": "ccuWIpEIrX_wmD5VsthErf1qNQbEK7IdG6fL1Il4KuA="
          }
      }
  • Authorized requests

    An authorized request is not automatically a detailed request.
    These requests however are not heavily rate limited like unauthorized requests.

    Examples
    • curl -X GET "https://api.id-converter.org/76561197960265729" \
      -H "Content-Type: application/json" \
      -H "Authorization: api-token"
      curl -X GET "https://api.id-converter.org/110000100000001?api-key=api-token" \
      -H "Content-Type: application/json"
    • {
          "error": false,
          "data": {
              "steam_url": "https://steamcommunity.com/profiles/76561197960265729",
              "steam_id_hex": "110000100000001",
              "steam_id64": "76561197960265729",
              "steam_id3": "[U:1:1]",
              "steam_id": "STEAM_0:1:0",
              "battleye_id": "74ae012b5407e0a3cc2cd82ec1f8ba7d",
              "bohemia_id": "ccuWIpEIrX_wmD5VsthErf1qNQbEK7IdG6fL1Il4KuA="
          }
      }
  • Detailed requests

    Detailed requests do not automatically include ban checks and details of known friends.
    They can be made by adding the GET parameter details to the request URI.
    Optional parameters are required to include ban checks and details of known friends.

    Examples
    • curl -X GET "https://api.id-converter.org/STEAM_0:1:0?details" \
      -H "Content-Type: application/json" \
      -H "Authorization: api-token"
      curl -X GET "https://api.id-converter.org/[U:1:1]?details&api-key=api-token" \
      -H "Content-Type: application/json"
    • {
          "error": false,
          "data": {
              "steam_avatar": "https://steamcdn-a...f56526a5d6989eb_full.jpg",
              "steam_url": "https://steamcommunity.com/profiles/76561197960265729",
              "steam_vanity_url": null,
              "steam_invite_url": "https://steamcommunity.com/user/c",
              "steam_configured": true,
              "steam_visibility": true,
              "steam_created": 1063193240,
              "steam_last_seen": null,
              "steam_origin": null,
              "steam_name": "rich",
              "steam_id_hex": "110000100000001",
              "steam_id64": "76561197960265729",
              "steam_id3": "[U:1:1]",
              "steam_id": "STEAM_0:1:0",
              "battleye_id": "74ae012b5407e0a3cc2cd82ec1f8ba7d",
              "bohemia_id": "ccuWIpEIrX_wmD5VsthErf1qNQbEK7IdG6fL1Il4KuA="
          }
      }


    Examples using optional parameters
    • curl -X GET "https://api.id-converter.org/STEAM_0:1:0?details&bans" \
      -H "Content-Type: application/json" \
      -H "Authorization: api-token"
      curl -X GET "https://api.id-converter.org/[U:1:1]?details&bans&api-key=api-token" \
      -H "Content-Type: application/json"
    • {
          "error": false,
          "data": {
              "steam_avatar": "https://steamcdn-a...f56526a5d6989eb_full.jpg",
              "steam_url": "https://steamcommunity.com/profiles/76561197960265729",
              "steam_vanity_url": null,
              "steam_invite_url": "https://steamcommunity.com/user/c",
              "steam_configured": true,
              "steam_visibility": true,
              "steam_created": 1063193240,
              "steam_last_seen": null,
              "steam_origin": null,
              "steam_name": "rich",
              "steam_id_hex": "110000100000001",
              "steam_id64": "76561197960265729",
              "steam_id3": "[U:1:1]",
              "steam_id": "STEAM_0:1:0",
              "battleye_id": "74ae012b5407e0a3cc2cd82ec1f8ba7d",
              "bohemia_id": "ccuWIpEIrX_wmD5VsthErf1qNQbEK7IdG6fL1Il4KuA=",
              "bans": {
                  "battleye": false,
                  "vac": 0,
                  "games": 0,
                  "economy": false,
                  "community": false,
                  "last_ban": {
                      "days": null,
                      "date": null
                  }
              }
          }
      }

    • curl -X GET "https://api.id-converter.org/STEAM_0:1:0?details&friends" \
      -H "Content-Type: application/json" \
      -H "Authorization: api-token"
      curl -X GET "https://api.id-converter.org/[U:1:1]?details&friends&api-key=api-token" \
      -H "Content-Type: application/json"
    • {
          "error": false,
          "data": {
              "steam_avatar": "https://steamcdn-a...f56526a5d6989eb_full.jpg",
              "steam_url": "https://steamcommunity.com/profiles/76561197960265729",
              "steam_vanity_url": null,
              "steam_invite_url": "https://steamcommunity.com/user/c",
              "steam_configured": true,
              "steam_visibility": true,
              "steam_created": 1063193240,
              "steam_last_seen": null,
              "steam_origin": null,
              "steam_name": "rich",
              "steam_id_hex": "110000100000001",
              "steam_id64": "76561197960265729",
              "steam_id3": "[U:1:1]",
              "steam_id": "STEAM_0:1:0",
              "battleye_id": "74ae012b5407e0a3cc2cd82ec1f8ba7d",
              "bohemia_id": "ccuWIpEIrX_wmD5VsthErf1qNQbEK7IdG6fL1Il4KuA=",
              "friends": []
          }
      }

Response

Content type application/json

  • No match found

    An invalid value passed in the request URI will return null as data in the response.

    {
        "error": false,
        "data": null
    }
  • Basic response

    Without using the GET parameter details the response only include ID conversions.

    {
        "error": false,
        "data": {
            "steam_url": "https://steamcommunity.com/profiles/76561197960265729",
            "steam_id_hex": "110000100000001",
            "steam_id64": "76561197960265729",
            "steam_id3": "[U:1:1]",
            "steam_id": "STEAM_0:1:0",
            "battleye_id": "74ae012b5407e0a3cc2cd82ec1f8ba7d",
            "bohemia_id": "ccuWIpEIrX_wmD5VsthErf1qNQbEK7IdG6fL1Il4KuA="
        }
    }
  • Detailed response

    Some fields can be null if they are not set or unavailable due to privacy reasons.

    {
        "error": false,
        "data": {
            "steam_avatar": "https://steamcdn-a...f56526a5d6989eb_full.jpg",
            "steam_url": "https://steamcommunity.com/profiles/76561197960265729",
            "steam_vanity_url": null,
            "steam_invite_url": "https://steamcommunity.com/user/c",
            "steam_configured": true,
            "steam_visibility": true,
            "steam_created": 1063193240,
            "steam_last_seen": null,
            "steam_origin": null,
            "steam_name": "rich",
            "steam_id_hex": "110000100000001",
            "steam_id64": "76561197960265729",
            "steam_id3": "[U:1:1]",
            "steam_id": "STEAM_0:1:0",
            "battleye_id": "74ae012b5407e0a3cc2cd82ec1f8ba7d",
            "bohemia_id": "ccuWIpEIrX_wmD5VsthErf1qNQbEK7IdG6fL1Il4KuA="
        }
    }
  • Data fields

    Frields marked as are only available in detailed requests
    Frields marked as are only available using the GET parameter bans
    Frields marked as are only available using the GET parameter friends
    Field Type Description
    steam_avatar string | null URL of the Steam profile avatar
    steam_url string URL of the Steam profile
    steam_vanity_url string | null Vanity URL of the Steam profile
    steam_invite_url string | null Invite URL of the Steam profile
    steam_configured boolean | null Indicates if the Steam community profile has been configured after it's creation
    steam_visibility boolean | null Indicates if details of the Steam profile are publicly visible
    steam_created integer | null Timestamp of the creation date of the Steam account (UTC)
    steam_last_seen integer | null Timestamp of the last logout of the Steam account (UTC)
    steam_origin string | null Currently set country code (ISO 3166, two letters)
    steam_name string Publicly visible Steam profile name
    steam_id_hex string Steam ID Hexadecimal
    steam_id64 string Steam ID 64
    steam_id3 string Steam ID 3
    steam_id string Steam ID (aka. Steam ID 2)
    battleye_id string Steam ID 64 hash by BattlEye
    bohemia_id string Steam ID 64 hash by Bohemia Interactive
    bans object
    bans->battleye boolean | null Banned by BattlEye
    bans->vac integer | null The amount of bans issued by Valve
    bans->games integer | null The amount of game bans
    bans->economy boolean | null Banned from the Steam community market
    bans->community boolean | null Banned from the Steam platform
    bans->last_ban object
    bans->last_ban->days integer | null The amount of days since the last ban
    bans->last_ban->date integer | null The date of the last ban (ISO 8601, YYYY-MM-DD) (UTC)
    friends array | false List of known account bans of friends
    (false indicates the account has a private friend list)
    friends->steam_url string URL of the Steam profile
    friends->steam_id_hex string Steam ID Hexadecimal
    friends->steam_id64 string Steam ID 64
    friends->battleye_id string Steam ID 64 hash by BattlEye
    friends->bohemia_id string Steam ID 64 hash by Bohemia Interactive
    friends->bans object
    friends->bans->battleye boolean | null Banned by BattlEye
    friends->bans->vac integer | null The amount of bans issued by Valve
    friends->bans->games integer | null The amount of game bans
    friends->bans->economy boolean | null Banned from the Steam community market
    friends->bans->community boolean | null Banned from the Steam platform
    friends->bans->last_ban object
    friends->bans->last_ban->days integer | null The amount of days since the last ban
    friends->bans->last_ban->date integer | null The date of the last ban (ISO 8601, YYYY-MM-DD) (UTC)
  • HTTP status codes

    Status code Message Description
    200 - The request has been made successfully
    400 Bad Request An invalid or no value has been passed to the request URI
    401 Unauthorized This request type requires an authentication
    The provided API token is invalid
    403 Forbidden The provided API token has been disabled
    404 - No match has been found based on the passed value
    429 Too Many Requests
    Daily Limited Exceeded
    The rate limit has been exceeded
    500 Internal Server Error An internal server error has occurred
    502 Bad Gateway An error has occurred while requesting an external service *
    504 Gateway Timeout A timeout has occurred while requesting an external service *

    *
    We depend on external services to fetch informations about Steam accounts and to determine possible bans. These services commonly experience outages.

Rate limit

Unauthorized requests

Requests without authentication are heavily rate limited.
Current limitation 200 requests per day

Authorized requests

The current amount of requests done using your API token can found in your user profile.
Current limitation 5000 requests per day

Exceeding the rate limit

When exceeding the rate limit the API will respond with an error.
Ignoring this error and continuing your requests can get your API token disabled.

  • {
        "error": true,
        "message": "Too Many Requests",
        "retry-after": 3600
    }
    The field retry-after will provide a timeout in seconds when you're allowed to do requests again.
    Too many requests per second have been done.
  • {
        "error": true,
        "message": "Daily Limited Exceeded",
        "retry-after": 10800
    }
    The field retry-after will provide a timeout in seconds when the daily limit will be reset.
    Too many requests have been done today.

Errors

Any occuring error will return the boolean true in the error field
The data field will not be available in the response
{
    "error": true,
    "message": "some-error-message"
}

Errors occuring on requests will still increase your request counter; handle them properly.



Please use a different browser!
Our website uses modern technologies to show the content.
Your browser is out to date and doesn't support those features.