# AWS Ground Station API

> AWS Ground Station API on Apizie: 33 endpoints (Describes an existing contact., Cancels a contact with a specified contact ID., Returns a list of Config objects., Creates a Config with the specified configData parameters. Only one type of configData can be specified., …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://zieapi.vercel.app/v1/cloud:amazonaws-groundstation/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:amazonaws-groundstation`
- Category: Cloud
- Status: byok
- Source: https://github.com/mermade/aws2openapi
- Page: https://zieapi.vercel.app/api/cloud/amazonaws-groundstation
- OpenAPI: https://zieapi.vercel.app/api/cloud/amazonaws-groundstation/openapi.json

Welcome to the AWS Ground Station API Reference. AWS Ground Station is a fully managed service that enables you to control satellite communications, downlink and process satellite data, and scale your satellite…

## Endpoints

### Describes an existing contact.
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-groundstation/describe-contact` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| contactId | string | yes | UUID of a contact. |

### Cancels a contact with a specified contact ID.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-groundstation/cancel-contact` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| contactId | string | yes | UUID of a contact. |

### Returns a list of Config objects.
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-groundstation/list-configs` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| maxResults | integer | no | Maximum number of Configs returned. |
| nextToken | string | no | Next token returned in the request of a previous ListConfigs call. Used to get the next page of results. |

### Creates a Config with the specified configData parameters. Only one type of configData can be specified.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-groundstation/create-config` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | yes | JSON request body |

### Returns a list of DataflowEndpoint groups.
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-groundstation/list-dataflow-endpoint-groups` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| maxResults | integer | no | Maximum number of dataflow endpoint groups returned. |
| nextToken | string | no | Next token returned in the request of a previous ListDataflowEndpointGroups call. Used to get the next page of results. |

### Creates a DataflowEndpoint group containing the specified list of DataflowEndpoint objects. The name field…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-groundstation/create-dataflow-endpoint-group` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | yes | JSON request body |

### Creates an Ephemeris with the specified EphemerisData .
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-groundstation/create-ephemeris` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | yes | JSON request body |

### Returns a list of mission profiles.
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-groundstation/list-mission-profiles` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| maxResults | integer | no | Maximum number of mission profiles returned. |
| nextToken | string | no | Next token returned in the request of a previous ListMissionProfiles call. Used to get the next page of results. |

### Creates a mission profile. dataflowEdges is a list of lists of strings. Each lower level list of strings has…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-groundstation/create-mission-profile` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | yes | JSON request body |

### Returns Config information. Only one Config response can be returned.
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-groundstation/get-config` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| configId | string | yes | UUID of a Config . |
| configType | string | yes | Type of a Config . |

### Updates the Config used when scheduling contacts. Updating a Config will not update the execution parameters…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-groundstation/update-config` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| configId | string | yes | UUID of a Config . |
| configType | string | yes | Type of a Config . |
| body | object | yes | JSON request body |

### Deletes a Config .
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-groundstation/delete-config` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| configId | string | yes | UUID of a Config . |
| configType | string | yes | Type of a Config . |

### Returns the dataflow endpoint group.
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-groundstation/get-dataflow-endpoint-group` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| dataflowEndpointGroupId | string | yes | UUID of a dataflow endpoint group. |

### Deletes a dataflow endpoint group.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-groundstation/delete-dataflow-endpoint-group` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| dataflowEndpointGroupId | string | yes | UUID of a dataflow endpoint group. |

### Describes an existing ephemeris.
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-groundstation/describe-ephemeris` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| ephemerisId | string | yes | The AWS Ground Station ephemeris ID. |

### Updates an existing ephemeris
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-groundstation/update-ephemeris` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| ephemerisId | string | yes | The AWS Ground Station ephemeris ID. |
| body | object | yes | JSON request body |

### Deletes an ephemeris
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-groundstation/delete-ephemeris` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| ephemerisId | string | yes | The AWS Ground Station ephemeris ID. |

### Returns a mission profile.
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-groundstation/get-mission-profile` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| missionProfileId | string | yes | UUID of a mission profile. |

### Updates a mission profile. Updating a mission profile will not update the execution parameters for existing…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-groundstation/update-mission-profile` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| missionProfileId | string | yes | UUID of a mission profile. |
| body | object | yes | JSON request body |

### Deletes a mission profile.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-groundstation/delete-mission-profile` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| missionProfileId | string | yes | UUID of a mission profile. |

### For use by AWS Ground Station Agent and shouldn't be called directly. Gets the latest configuration…
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-groundstation/get-agent-configuration` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| agentId | string | yes | UUID of agent to get configuration information for. |

### Returns the number of reserved minutes used by account.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-groundstation/get-minute-usage` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | yes | JSON request body |

### Returns a satellite.
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-groundstation/get-satellite` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| satelliteId | string | yes | UUID of a satellite. |

### Returns a list of contacts. If statusList contains AVAILABLE, the request must include groundStation ,…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-groundstation/list-contacts` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| maxResults | string | no | Pagination limit |
| nextToken | string | no | Pagination token |
| body | object | yes | JSON request body |

### List existing ephemerides.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-groundstation/list-ephemerides` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| maxResults | integer | no | Maximum number of ephemerides to return. |
| nextToken | string | no | Pagination token. |
| body | object | yes | JSON request body |

### Returns a list of ground stations.
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-groundstation/list-ground-stations` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| maxResults | integer | no | Maximum number of ground stations returned. |
| nextToken | string | no | Next token that can be supplied in the next call to get the next page of ground stations. |
| satelliteId | string | no | Satellite ID to retrieve on-boarded ground stations. |

### Returns a list of satellites.
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-groundstation/list-satellites` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| maxResults | integer | no | Maximum number of satellites returned. |
| nextToken | string | no | Next token that can be supplied in the next call to get the next page of satellites. |

### Returns a list of tags for a specified resource.
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-groundstation/list-tags-for-resource` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| resourceArn | string | yes | ARN of a resource. |

### Assigns a tag to a resource.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-groundstation/tag-resource` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| resourceArn | string | yes | ARN of a resource tag. |
| body | object | yes | JSON request body |

### For use by AWS Ground Station Agent and shouldn't be called directly. Registers a new agent with AWS Ground…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-groundstation/register-agent` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | yes | JSON request body |

### Reserves a contact using specified parameters.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-groundstation/reserve-contact` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | yes | JSON request body |

### Deassigns a resource tag.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-groundstation/untag-resource` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| resourceArn | string | yes | ARN of a resource. |
| tagKeys | array | yes | Keys of a resource tag. |

### For use by AWS Ground Station Agent and shouldn't be called directly. Update the status of the agent.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-groundstation/update-agent-status` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| agentId | string | yes | UUID of agent to update. |
| body | object | yes | JSON request body |

## Example
```
curl "https://zieapi.vercel.app/v1/cloud:amazonaws-groundstation/describe-contact" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the AWS Ground Station API?
Create a free Apizie key, then send GET https://zieapi.vercel.app/v1/cloud:amazonaws-groundstation/describe-contact with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the AWS Ground Station API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. AWS Ground Station itself also needs your own key from amazonaws.com.

### Can AI agents use the AWS Ground Station API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:amazonaws-groundstation.

### What is the status of the AWS Ground Station API?
Needs your own provider key (bring your own key)