# Mothership Documentation

> Mothership API

## Guides
- [Setting Up Authentication](https://developers.mothership.com/docs/booking-authentication.md)
- [Getting Rates](https://developers.mothership.com/docs/booking-rates.md)
- [Setting Up Authentication](https://developers.mothership.com/docs/setting-up-authentication-2-1.md)
- [Creating a Webhook Configuration](https://developers.mothership.com/docs/webhook-create.md)
- [Receiving Webhook Requests](https://developers.mothership.com/docs/receiving-webhooks.md)

## API Reference
- [Overview](https://developers.mothership.com/reference/overview.md)
- [Webhooks](https://developers.mothership.com/reference/webhooks-1.md)
- [Retrieve account](https://developers.mothership.com/reference/getaccount.md): This endpoint allows a user to retrieve details about their company account
- [List shipment documents](https://developers.mothership.com/reference/listshipmentdocuments.md): This endpoint allows a user to generate URLs directing to shipment documents like the Bill of Lading and Proof of Delivery, if available.
- [Retrieve a file](https://developers.mothership.com/reference/fetchfilebyid.md): This endpoint allows you to retrieve a download url for a file by file Id
- [List all modified invoices](https://developers.mothership.com/reference/listmodifiedinvoices.md): This endpoint allows a user to pass in an ISO timestamp and receive a list of references to invoices that have either been created or modified on or after that date.
- [Retrieve an invoice](https://developers.mothership.com/reference/fetchinvoicebyid.md): This endpoint allows a user to retrieve an invoice
- [List invoices by shipment identifier](https://developers.mothership.com/reference/listinvoicesbyshipmentid.md): This endpoint allows a user to retrieve all invoices associated with a specific shipment identifier.
- [Create a quote](https://developers.mothership.com/reference/createquote.md): This endpoint allows a user to pass in shipment details and create a quote. This response will return the available rates with respective prices, and also return a quote ID that can be used in the Create Shipment endpoint.
- [Create a shipment](https://developers.mothership.com/reference/createshipment.md): This endpoint allows a user to purchase and create a shipment under his/her shipper account.
- [List Shipments](https://developers.mothership.com/reference/listshipments.md): This endpoint allows a user to list all shipments booked by his/her organization.
- [Retrieve a shipment](https://developers.mothership.com/reference/getshipmentdetails.md): This endpoint allows a user to get up-to-date shipment details for the shipment represented by the given Shipment ID
- [Cancel a shipment](https://developers.mothership.com/reference/cancelshipment.md): Attempts to cancel the shipment immediately. By default, the request only succeeds when the currently available cancellation path is free. Callers can opt in to paid cancellation by setting acceptFees and optionally supplying a limitAmountCents cap.
- [List webhooks](https://developers.mothership.com/reference/fetchwebhookconfigsforaccount.md): This endpoint allows a user to fetch all webhook configs set up for his/her shipper account.
- [Create a webhook configuration](https://developers.mothership.com/reference/createwebhookconfig.md): This endpoint allows a user to create a webhook config for his/her shipper account.
- [Retrieve a webhook configuration](https://developers.mothership.com/reference/fetchwebhookconfig.md): This endpoint allows a user to fetch the webhook config represented by webhookConfigId.
- [Update a webhook configuration](https://developers.mothership.com/reference/updatewebhookconfig.md): This endpoint allows a user to update the webhook config represented by webhookConfigId.
- [Remove a webhook configuration](https://developers.mothership.com/reference/removewebhookconfig.md): This endpoint allows a user to remove the webhook config represented by webhookConfigId.
- [(deprecated) Search for a place](https://developers.mothership.com/reference/fetchplaces-1.md): This endpoint allows a user to retrieve an array of place IDs that represent addresses that may be used as the pickup location or delivery for a quote.
- [(deprecated) Retrieve a place](https://developers.mothership.com/reference/fetchplace-1.md): This endpoint allows a user to fetch address details for the given place ID.
- [Track a shipment](https://developers.mothership.com/reference/fetchshipmenttracking.md): This endpoint allows a user to get a list of tracking events related to a shipment
- [Shipment Statuses](https://developers.mothership.com/reference/shipment-status.md)
- [Accessorials](https://developers.mothership.com/reference/accessorials.md): List of accessorial charges
- [Rate Services](https://developers.mothership.com/reference/rate-services.md): Rates often provide additional services. The "services" array may contain any of the following services:
- [Providers](https://developers.mothership.com/reference/providers.md): Each rate will be from a specific provider listed below.
- [Invoice Line Items](https://developers.mothership.com/reference/invoice-line-items.md): When reviewing a freight invoice, each line item represents a specific charge or adjustment related to the shipment. Below is a guide to help you understand what each type of line item means: