canonical: https://jentic.com/apis/swapi.dev/swapi-dev

# SWAPI - The Star Wars API

The Star Wars API (SWAPI) provides data about the Star Wars universe including people, planets, films, species, vehicles, and starships. All data is freely available with no authentication required. The API exposes 13 endpoints.

## For AI agents

Programmatically list all available resources, list all people. Covers 13 operations.

## Scope

Does not handle payments, communications, or crm - use for identity and authentication only.

## Capabilities

- List all available resources
- Get a specific person
- Integrate SWAPI - The Star Wars API into automated workflows
- Query and filter SWAPI - The Star Wars API records by parameters
- Monitor SWAPI - The Star Wars API operational status and events

## Use cases

### Identity and Authentication Operations

Use the SWAPI - The Star Wars API to perform identity auth operations programmatically. The API provides 13 endpoints covering core functionality including list all available resources, list all people, get a specific person.

Example prompt: Call GET / to list all available resources

### Automated default Management

Automate default operations by combining multiple SWAPI - The Star Wars API endpoints. Agents can list all people and then get a specific person in a single workflow.

Example prompt: Call GET /people/ to list all people, then verify the result

### AI Agent Integration via Jentic

AI agents discover and call SWAPI - The Star Wars API endpoints through Jentic without managing credentials directly. An agent searches for the required operation by intent, receives the matching endpoint schema, and executes the call with Jentic-managed authentication. This eliminates the need to read API documentation or handle none tokens manually.

Example prompt: Search Jentic for 'list all available resources', load the operation schema, and execute with Jentic-managed credentials

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/` | List all available resources |
| GET | `/people/` | List all people |
| GET | `/people/{id}/` | Get a specific person |
| GET | `/planets/` | List all planets |
| GET | `/planets/{id}/` | Get a specific planet |
| GET | `/films/` | List all films |
| GET | `/films/{id}/` | Get a specific film |
| GET | `/species/` | List all species |

## Key resources

- **default** — Operations related to default
- **films** — Operations related to films
- **people** — Operations related to people
- **planets** — Operations related to planets
- **species** — Operations related to species

## AI readiness

This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.

- **Score:** 63 / 100
- **Maturity:** AI-Aware
- **Dimensions:**
  - Foundational Compliance: 71 / 100
  - Developer Experience & Jentic Compatibility: 59 / 100
  - AI-Readiness & Agent Experience: 53 / 100
  - Agent Usability: 94 / 100
  - Security: 100 / 100
  - AI Discoverability: 37 / 100
- **View full report:** https://jentic.com/apis/swapi.dev/swapi-dev/scorecard
- **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/
- **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview

### Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

- **Score your own API:** https://jentic.com/scorecard.md
- **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md

```sh
npx @jentic/api-scorecard-cli score <openapi-url>
```

## Why Jentic

- **Setup:** Wiring SWAPI, the Star Wars API, by hand means coding its people, planet, film, and species calls against its host and paging through each list yourself. Through Jentic you install once, import SWAPI from the API Directory, and your agent calls it.
- **Permission scoping:** SWAPI puts each resource id in the URL path (`/people/{id}`/, `/planets/{id}`/), and every endpoint is a read-only GET, so a rule can pin your agent to reading a single person, planet, film, or species. There are no write or delete operations to include.
- **Credential handling:** SWAPI needs no credential, and if you configure one it is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'list all available resources' or 'get a character by id', and Jentic returns the matching SWAPI operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Auth0** — Alternative identity auth API
- **Okta** — Alternative identity auth API

## FAQ

### What authentication does the SWAPI - The Star Wars API use?

The SWAPI - The Star Wars API uses no authentication. Through Jentic, these credentials are stored encrypted in your Jentic One instance and injected at execution time, so raw secrets never enter the agent context.

### Can I list all available resources with the SWAPI - The Star Wars API?

Yes. Use the GET / endpoint. The API returns structured JSON responses that agents can parse and act on directly.

### What are the rate limits for the SWAPI - The Star Wars API?

Rate limits are not specified in the OpenAPI spec. Check the vendor documentation for current limits. Through Jentic, rate limiting is handled automatically with retry logic built into the execution layer.

### How do I list all available resources through Jentic?

Install the Jentic SDK with pip install jentic, authenticate through Jentic One, the self-hosted execution layer, then search for 'list all available resources'. Jentic returns the matching SWAPI - The Star Wars API operation with its input schema. Load the schema and execute the call - credentials are injected automatically.

### How many endpoints does the SWAPI - The Star Wars API have?

The SWAPI - The Star Wars API exposes 13 endpoints covering default, films, people operations.

### Can I limit what my agent is allowed to do with the SWAPI - The Star Wars API?

Yes. Because you run Jentic One yourself, your own rules decide which SWAPI operations the agent may call. Every SWAPI endpoint is a read-only GET and each resource id sits in the URL path, such as `/people/{id}`/ or `/planets/{id}`/, so you can pin the agent to reading a single person, planet, film, or species and block the broader list calls. There are no write or delete operations to allow, so the agent can only read the data you permit.