> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shipstar.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List Published Blog Posts

> List all published blog posts, newest first

Returns an array of all published blog posts with their content and metadata, ordered by most recent first. This endpoint does not require authentication.

## Request

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET "https://app.shipstar.ai/api/v1/blogs"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('https://app.shipstar.ai/api/v1/blogs');
  const posts = await response.json();
  ```

  ```python Python theme={null}
  import requests

  response = requests.get('https://app.shipstar.ai/api/v1/blogs')
  posts = response.json()
  ```
</CodeGroup>

## Response

Returns an array of blog post objects. Each post includes markdown content and metadata.

### Example Response

```json 200 theme={null}
[
  {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "slug": "weekly-update-march-31-2025",
    "content": "# What We Shipped This Week\n\nThis week we focused on...",
    "period_start": "2025-03-24T00:00:00Z",
    "period_end": "2025-03-31T23:59:59Z",
    "published_at": "2025-03-31T12:00:00Z",
    "created_at": "2025-03-31T10:00:00Z"
  }
]
```