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.
openapi: 3.2.0
info:
title: NASA Mars Rover Photos Manifests Rovers API
description: 'REST API providing images captured by NASA''s Curiosity, Opportunity, Spirit, and Perseverance Mars rovers. Photos can be queried by Martian sol (day since landing), Earth date, and camera type. Mission manifest data is available per rover with landing dates, launch dates, rover status, and per-sol photo breakdowns.
'
version: 1.1.2
contact:
name: NASA APIs Team
url: https://api.nasa.gov/
license:
name: Public Domain (U.S. Government Work)
url: https://www.usa.gov/government-works
servers:
- url: https://api.nasa.gov/mars-photos/api/v1
description: NASA Open APIs production server
security:
- apiKeyQuery: []
tags:
- name: Rovers
description: List and inspect Mars rover records.
paths:
/rovers:
get:
operationId: listRovers
summary: List all Mars rovers
description: Returns a list of all Mars rovers and their mission details.
tags:
- Rovers
parameters:
- $ref: '#/components/parameters/apiKey'
responses:
'200':
description: A list of rover objects.
content:
application/json:
schema:
$ref: '#/components/schemas/RoversResponse'
'403':
description: Forbidden — invalid or missing API key.
components:
parameters:
apiKey:
name: api_key
in: query
required: false
description: NASA API key. Use DEMO_KEY for testing.
schema:
type: string
default: DEMO_KEY
example: DEMO_KEY
schemas:
Rover:
type: object
description: Full rover record.
properties:
id:
type: integer
example: 5
name:
type: string
example: Curiosity
landing_date:
type: string
format: date
example: '2012-08-06'
launch_date:
type: string
format: date
example: '2011-11-26'
status:
type: string
enum:
- active
- complete
example: active
max_sol:
type: integer
example: 4102
max_date:
type: string
format: date
example: '2024-03-15'
total_photos:
type: integer
example: 695670
cameras:
type: array
items:
type: object
properties:
id:
type: integer
name:
type: string
rover_id:
type: integer
full_name:
type: string
RoversResponse:
type: object
properties:
rovers:
type: array
items:
$ref: '#/components/schemas/Rover'
securitySchemes:
apiKeyQuery:
type: apiKey
in: query
name: api_key
externalDocs:
description: NASA Open APIs Documentation
url: https://api.nasa.gov/#MarsPhotos