ISS Location API (Open Notify)

ISS Location API (Open Notify) ISS Location API

Endpoints for retrieving the current position of the International Space Station

Documentation GitHub OpenAPI

Operations 2

GET /iss-now.json Get Current ISS Location #

GET /iss-now/v1/ Get Current ISS Location (v1) #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/iss-api-iss-location-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: (Open Notify) ISS Location API
  description: Open Notify is a free, open-source project by Nathan Bergey that exposes real-time NASA and ISS data as simple REST endpoints.
  version: '1.0'
  contact:
    name: Open Notify
    url: http://open-notify.org/
  license:
    name: MIT
    url: https://github.com/open-notify/Open-Notify-API/blob/master/LICENSE
servers:
- url: http://api.open-notify.org
  description: Open Notify production server
tags:
- name: ISS Location
  description: Endpoints for retrieving the current position of the International Space Station
paths:
  /iss-now.json:
    get:
      operationId: getISSLocationNow
      summary: Get Current ISS Location
      description: Returns the current latitude and longitude of the International Space Station along with a Unix timestamp indicating when the coordinates were recorded. No parameters are required. The data is refreshed approximately every five seconds as the ISS orbits Earth at roughly 28,000 km/h and at an altitude of approximately 400 km.
      tags:
      - ISS Location
      responses:
        '200':
          description: Current ISS location successfully retrieved
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ISSLocationResponse'
              example:
                iss_position:
                  latitude: -19.783929798887073
                  longitude: -72.29753187401747
                message: success
                timestamp: 1454357342
  /iss-now/v1/:
    get:
      operationId: getISSLocationNowV1
      summary: Get Current ISS Location (v1)
      description: Alternate versioned route for the ISS current location endpoint. Returns the current latitude and longitude of the International Space Station along with a Unix timestamp.
      tags:
      - ISS Location
      responses:
        '200':
          description: Current ISS location successfully retrieved
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ISSLocationResponse'
              example:
                iss_position:
                  latitude: -19.783929798887073
                  longitude: -72.29753187401747
                message: success
                timestamp: 1454357342
components:
  schemas:
    ISSPosition:
      type: object
      description: Earth position coordinates directly beneath the ISS
      properties:
        latitude:
          type: number
          format: double
          description: Latitude coordinate in decimal degrees
          minimum: -90
          maximum: 90
          example: -19.783929798887073
        longitude:
          type: number
          format: double
          description: Longitude coordinate in decimal degrees
          minimum: -180
          maximum: 180
          example: -72.29753187401747
      required:
      - latitude
      - longitude
    ISSLocationResponse:
      type: object
      description: Response from the ISS current location endpoint
      properties:
        message:
          type: string
          description: Operation status indicator
          example: success
        timestamp:
          type: integer
          format: int64
          description: Unix timestamp (seconds since epoch) when the location data was captured
          example: 1454357342
        iss_position:
          $ref: '#/components/schemas/ISSPosition'
      required:
      - message
      - timestamp
      - iss_position
externalDocs:
  description: Open Notify API Documentation
  url: http://open-notify.org/Open-Notify-API/