### Example API Response

Source: https://docs.mightynetworks.com/authentication

This is an example of a successful response when testing your API authentication.

```json
{
  "id": "12345",
  "name": "John Doe",
  "email": "john@example.com",
  "network_id": "67890",
  "role": "admin",
  "created_at": "2024-01-15T10:30:00Z"
}
```

--------------------------------

### Make Authenticated API Request (Node.js)

Source: https://docs.mightynetworks.com/authentication

This Node.js example demonstrates how to make an authenticated GET request using the 'node-fetch' library. Ensure you have 'node-fetch' installed and replace placeholders with your token and network ID.

```javascript
const fetch = require('node-fetch');

const API_TOKEN = 'your_api_token';
const NETWORK_ID = 'your_network_id';

const response = await fetch(
  `https://api.mn.co/admin/v1/networks/${NETWORK_ID}/members`,
  {
    headers: {
      'Authorization': `Bearer ${API_TOKEN}`,
      'Content-Type': 'application/json'
    }
  }
);

const data = await response.json();
```

--------------------------------

### Make Authenticated API Request (Ruby)

Source: https://docs.mightynetworks.com/authentication

This Ruby example uses 'net/http' to make an authenticated GET request. Configure your API token and network ID, and include the 'Authorization' header.

```ruby
require 'net/http'
require 'json'

api_token = 'your_api_token'
network_id = 'your_network_id'

uri = URI("https://api.mn.co/admin/v1/networks/#{network_id}/members")
request = Net::HTTP::Get.new(uri)
request['Authorization'] = "Bearer #{api_token}"
request['Content-Type'] = 'application/json'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end

data = JSON.parse(response.body)
```

--------------------------------

### Webhook Delivery Format Example

Source: https://docs.mightynetworks.com/admin-api

Example of the JSON payload structure for a webhook POST request. Ensure your endpoint handles this format and includes the Authorization header.

```http
POST /your-webhook-endpoint
Host: your-domain.com
Content-Type: application/json
Accept: application/json
Authorization: Bearer YOUR_CONFIGURED_API_KEY

{
  "event_id": "abc123-uuid",
  "event_timestamp": "2024-01-15T10:30:00Z",
  "event_type": "PostCreated",
  "payload": {
    "id": 12345,
    "title": "Example post title",
    "author": {
      "id": 67890,
      "email": "user@example.com",
      "first_name": "John"
    },
    "space_id": 111,
    "created_at": "2024-01-15T10:30:00Z"
  }
}
```

--------------------------------

### Example API Request

Source: https://docs.mightynetworks.com/admin-api

All API requests require authentication using a Bearer token and specify the content type as JSON. This example shows a typical request structure using curl.

```bash
curl https://api.mn.co/admin/v1/networks/{network_id}/endpoint \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"
```

--------------------------------

### MemberCourseProgressStarted Webhook

Source: https://docs.mightynetworks.com/api-reference/webhooks/membercourseprogressstarted

This webhook is triggered when a member starts a course. It is part of the Mighty Networks Admin API.

```APIDOC
## Webhook: MemberCourseProgressStarted

### Description
Triggered when a member starts a course.

### Method
POST

### Endpoint
/webhooks/MemberCourseProgressStarted

### Request Body
- **member_id** (string) - Required - The ID of the member who started the course.
- **course_id** (string) - Required - The ID of the course that was started.

### Response
#### Success Response (200)
- **message** (string) - A confirmation message.

#### Response Example
```json
{
  "message": "Course progress started event received successfully."
}
```
```

--------------------------------

### Example API Request with Pagination Parameters

Source: https://docs.mightynetworks.com/api-pagination

Demonstrates how to construct a cURL request to fetch a specific page of members with a custom number of items per page.

```bash
curl "https://api.mn.co/admin/v1/networks/{network_id}/members?page=2&per_page=50" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
```

--------------------------------

### Example Not Found Error Response (404)

Source: https://docs.mightynetworks.com/api-error-handling

Shows the JSON response for a 404 Not Found error, indicating that the requested resource does not exist.

```json
{
  "error": "Member not found"
}
```

--------------------------------

### Test API Authentication with Node.js

Source: https://docs.mightynetworks.com/authentication

Use this Node.js fetch example to verify your API token is working by making a request to the /me endpoint. Ensure you have your API_TOKEN and NETWORK_ID defined.

```javascript
const response = await fetch(
    `https://api.mn.co/admin/v1/networks/${NETWORK_ID}/me`,
    {
      headers: {
        'Authorization': `Bearer ${API_TOKEN}`
      }
    }
  );

  const data = await response.json();
  console.log('Authenticated as:', data);
```

--------------------------------

### Create a Post with Notifications

Source: https://docs.mightynetworks.com/posts

When creating a post, append `?notify=true` to the URL to send push notifications and emails to network members. This requires the same authentication and content type as a standard post creation.

```bash
curl -X POST "https://api.mn.co/admin/v1/networks/{network_id}/posts?notify=true" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "body": "Important announcement for all members!",
    "space_id": 456
  }'
```

--------------------------------

### Handling Resource Not Found Errors (404)

Source: https://docs.mightynetworks.com/api-error-handling

This JavaScript snippet demonstrates fetching a member and handling a 404 Not Found response, suggesting graceful handling for missing resources.

```javascript
const response = await fetch(
  `https://api.mn.co/admin/v1/networks/${NETWORK_ID}/members/${MEMBER_ID}/`,
  { headers: { 'Authorization': `Bearer ${API_TOKEN}` } }
);

if (response.status === 404) {
  console.error('Member not found. They may have been deleted.');
  // Handle missing resource gracefully
  return null;
}
```

--------------------------------

### Get Specific Post

Source: https://docs.mightynetworks.com/posts

Retrieves the details of a single post by its ID.

```APIDOC
## GET /admin/v1/networks/{network_id}/posts/{post_id}/

### Description
Fetches the detailed information for a specific post identified by its unique ID within a given network.

### Method
GET

### Endpoint
/admin/v1/networks/{network_id}/posts/{post_id}/

### Parameters
#### Path Parameters
- **network_id** (string) - Required - The unique identifier for the network.
- **post_id** (string) - Required - The unique identifier for the post.

### Request Example
```bash
curl https://api.mn.co/admin/v1/networks/123/posts/98765/ \
  -H "Authorization: Bearer YOUR_API_TOKEN"
```

### Response
#### Success Response (200)
- **id** (integer) - The unique identifier of the post.
- **body** (string) - The content of the post.
- **author_id** (integer) - The ID of the member who created the post.
- **space_id** (integer) - The ID of the space where the post was created.
- **created_at** (string) - The timestamp when the post was created.
- **updated_at** (string) - The timestamp when the post was last updated.
- **comments_count** (integer) - The number of comments on the post.
- **reactions_count** (integer) - The number of reactions on the post.

#### Response Example
```json
{
  "id": 98765,
  "body": "Welcome to our community! Excited to connect with everyone.",
  "author_id": 12345,
  "space_id": 456,
  "created_at": "2024-03-20T14:30:00Z",
  "updated_at": "2024-03-20T14:30:00Z",
  "comments_count": 5,
  "reactions_count": 12
}
```
```

--------------------------------

### GET /admin/v1/networks/{network_id}/tags/{id}/

Source: https://docs.mightynetworks.com/api-reference/tags/return-a-single-tag-by-id

Retrieves a specific tag within a network by its ID.

```APIDOC
## GET /admin/v1/networks/{network_id}/tags/{id}/

### Description
Return a single tag by ID.

### Method
GET

### Endpoint
/admin/v1/networks/{network_id}/tags/{id}/

### Parameters
#### Path Parameters
- **id** (integer) - Required - ID of the tag
- **network_id** (integer | string) - Required - The Network's unique integer ID, or subdomain

### Response
#### Success Response (200)
- **id** (integer) - The record's integer ID
- **created_at** (string) - The date and time the record was created
- **updated_at** (string) - The date and time the record was last modified
- **title** (string) - The title of the tag
- **description** (string) - The description of the tag
- **color** (string) - The hex color code for the tag
- **custom_field_id** (integer) - The ID of the custom field this tag belongs to

#### Response Example
{
  "example": "{\"id\": 1234, \"created_at\": \"2026-04-25T00:25:56+00:00\", \"updated_at\": \"2026-04-25T00:25:56+00:00\", \"title\": \"VIP Member\", \"description\": \"Premium tier members\", \"color\": \"#FF5733\", \"custom_field_id\": 5678}"
}

#### Error Response (404)
- **error** (string) - Description of the error

#### Response Example
{
  "example": "{\"error\": \"Tag not found\"}"
}
```

--------------------------------

### Best Practices

Source: https://docs.mightynetworks.com/admin-api

Recommended practices for using the Admin API, including security, rate limiting, and error handling.

```APIDOC
## Best Practices

1. **Store tokens securely** - Never expose API tokens in client-side code or public repositories
2. **Handle rate limits** - Implement exponential backoff when hitting rate limits
3. **Use pagination** - Always paginate through large result sets
4. **Validate input** - Validate data before sending to the API
5. **Monitor errors** - Log and monitor API errors for debugging
```

--------------------------------

### GET /admin/v1/networks/{network_id}/purchases/{id}/

Source: https://docs.mightynetworks.com/api-reference/purchases/return-a-single-purchase-by-id

Retrieves details of a specific purchase within a network.

```APIDOC
## GET /admin/v1/networks/{network_id}/purchases/{id}/

### Description
Retrieves a single purchase by its unique identifier within a specified network.

### Method
GET

### Endpoint
/admin/v1/networks/{network_id}/purchases/{id}/

### Parameters
#### Path Parameters
- **network_id** (oneOf(integer, string)) - Required - The Network's unique integer ID, or subdomain.
- **id** (integer) - Required - ID of the purchase.

### Response
#### Success Response (200)
- **member_id** (integer) - ID of the member who made the purchase
- **member_email** (string) - Email of the member
- **member_first_name** (string) - Member's first name
- **member_last_name** (string) - Member's last name
- **member_time_zone** (string) - Member's time zone
- **member_location** (string) - Member's location
- **member_referral_count** (integer) - Number of referrals made by this member
- **member_avatar** (string) - URL to the member's avatar image
- **member_categories** (string) - Array of category objects with id and title
- **member_permalink** (string) - URL to member's profile page
- **member_ambassador_level** (string) - Member's ambassador level

#### Response Example
{
  "member_id": 12345,
  "member_email": "ada.lovelace@example.com",
  "member_first_name": "Ada",
  "member_last_name": "Lovelace",
  "member_time_zone": "UTC",
  "member_location": "London, UK",
  "member_referral_count": 5,
  "member_avatar": "https://example.com/avatar.jpg",
  "member_categories": "[]",
  "member_permalink": "/members/ada-lovelace",
  "member_ambassador_level": "Gold"
}

#### Error Response (404)
- **ErrorResponse** (object) - Indicates that the purchase was not found.

#### Response Example
{
  "error": "Purchase not found"
}
```

--------------------------------

### GET /admin/v1/networks/{network_id}/events/{id}/

Source: https://docs.mightynetworks.com/api-reference/events/returns-details-of-a-specific-event

Retrieves the details of a specific event within a network.

```APIDOC
## GET /admin/v1/networks/{network_id}/events/{id}/

### Description
Retrieves the details of a specific event within a network.

### Method
GET

### Endpoint
/admin/v1/networks/{network_id}/events/{id}/

### Parameters
#### Path Parameters
- **network_id** (integer | string) - Required - The Network's unique integer ID, or subdomain
- **id** (integer) - Required - ID of the event

### Response
#### Success Response (200)
- **id** (integer) - The record's integer ID
- **created_at** (string) - The date and time the record was created
- **updated_at** (string) - The date and time the record was last modified
- **post_type** (string) - The type of post - always 'event' for this endpoint
- **creator** (object) - The user who created the event
- **images** (array) - Array of image URLs for the event
- **permalink** (string) - Full URL to view the event
- **title** (string) - The title of the event

#### Response Example
{
  "example": "{\"id\": 1234, \"created_at\": \"2026-04-25T00:25:56+00:00\", \"updated_at\": \"2026-04-25T00:25:56+00:00\", \"post_type\": \"event\", \"creator\": { ... }, \"images\": [\"url1\", \"url2\"], \"permalink\": \"https://example.mn.co/posts/123\", \"title\": \"Example Event\"}"
}

#### Error Response (404)
- **message** (string) - Description of the error
- **code** (string) - Error code

#### Response Example
{
  "example": "{\"message\": \"Event not found\", \"code\": \"NOT_FOUND\"}"
}
```

--------------------------------

### GET /admin/v1/networks/{network_id}/collections

Source: https://docs.mightynetworks.com/api-reference/collections/return-all-collections-in-the-network

Retrieves a paginated list of all collections within a specified network.

```APIDOC
## GET /admin/v1/networks/{network_id}/collections

### Description
Return all collections in the network

### Method
GET

### Endpoint
/admin/v1/networks/{network_id}/collections

### Parameters
#### Path Parameters
- **network_id** (oneOf(integer, string)) - Required - The Network's unique integer ID, or subdomain

#### Query Parameters
- **page** (integer) - Optional - Page number for pagination
- **per_page** (integer) - Optional - Items per page (max 100)

### Response
#### Success Response (200)
- A paginated set of collection objects

### Request Example
```json
{
  "example": "request body"
}
```

### Response Example
```json
{
  "example": "response body"
}
```
```

--------------------------------

### Get Custom Field Answer

Source: https://docs.mightynetworks.com/api-reference/answers/return-a-single-response-by-id

Retrieves a specific answer provided by a member to a custom field.

```APIDOC
## GET /admin/v1/networks/{network_id}/custom_fields/{custom_field_id}/members/{member_id}/answers/{id}/

### Description
Retrieves a single custom field answer by its unique ID.

### Method
GET

### Endpoint
/admin/v1/networks/{network_id}/custom_fields/{custom_field_id}/members/{member_id}/answers/{id}/

### Parameters
#### Path Parameters
- **network_id** (integer | string) - Required - The Network's unique integer ID, or subdomain
- **custom_field_id** (integer) - Required - ID of the custom field
- **member_id** (integer) - Required - ID of the member
- **id** (integer) - Required - ID of the response

### Responses
#### Success Response (200)
- **id** (integer) - The record's integer ID
- **created_at** (string) - The date and time the record was created
- **updated_at** (string) - The date and time the record was last modified
- **user_id** (integer) - The ID of the user who provided the answer
- **custom_field_id** (integer) - The ID of the custom field the answer belongs to
- **last_edited_at** (string) - The date and time the answer was last edited

#### Response Example (200)
{
  "id": 1234,
  "created_at": "2026-04-25T00:25:56+00:00",
  "updated_at": "2026-04-25T00:25:56+00:00",
  "user_id": 5678,
  "custom_field_id": 9101,
  "last_edited_at": "2026-04-25T00:25:56+00:00"
}

#### Error Response (404)
- **message** (string) - Description of the error
- **code** (integer) - Error code
- **status** (string) - HTTP status code

#### Response Example (404)
{
  "message": "Custom field, member, or response not found.",
  "code": 404,
  "status": "NOT_FOUND"
}
```

--------------------------------

### Create a New Post

Source: https://docs.mightynetworks.com/posts

Submit a POST request to create a new post in your network. Include the post content and optionally a space ID. Authentication and content type headers are mandatory.

```bash
curl -X POST https://api.mn.co/admin/v1/networks/{network_id}/posts \
    -H "Authorization: Bearer YOUR_API_TOKEN" \
    -H "Content-Type: application/json" \
    -d '{
      "body": "This is my post content",
      "space_id": 456
    }'
```

```javascript
const response = await fetch(
    `https://api.mn.co/admin/v1/networks/${NETWORK_ID}/posts`,
    {
      method: 'POST',
      headers: {
        'Authorization': `Bearer ${API_TOKEN}`,
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
        body: 'This is my post content',
        space_id: 456
      })
    }
  );

  const newPost = await response.json();
```

```python
response = requests.post(
      f"https://api.mn.co/admin/v1/networks/{NETWORK_ID}/posts",
      headers={
          "Authorization": f"Bearer {API_TOKEN}",
          "Content-Type": "application/json"
      },
      json={
          "body": "This is my post content",
          "space_id": 456
      }
  )

  new_post = response.json()
```

--------------------------------

### Get Specific Member

Source: https://docs.mightynetworks.com/members

Retrieves detailed information for a single member using their unique Member ID.

```APIDOC
## GET /admin/v1/networks/{network_id}/members/{member_id}/

### Description
Retrieves detailed information about a specific member identified by their unique Member ID.

### Method
GET

### Endpoint
/admin/v1/networks/{network_id}/members/{member_id}/

### Parameters
#### Path Parameters
- **network_id** (string) - Required - The unique identifier for the network.
- **member_id** (string) - Required - The unique identifier for the member.

### Response
#### Success Response (200)
- **id** (integer) - The unique identifier for the member.
- **email** (string) - The member's email address.
- **first_name** (string) - The member's first name.
- **last_name** (string) - The member's last name.
- **avatar** (string) - URL to the member's avatar image.
- **location** (string) - The member's location.
- **time_zone** (string) - The member's time zone.
- **permalink** (string) - URL to the member's profile page.
- **created_at** (string) - Timestamp when the member joined.
- **updated_at** (string) - Timestamp when the member's profile was last updated.

#### Response Example
```json
{
  "id": 12345,
  "email": "john.doe@example.com",
  "first_name": "John",
  "last_name": "Doe",
  "avatar": "https://cdn.mn.co/avatars/12345.jpg",
  "location": "San Francisco, CA",
  "time_zone": "America/Los_Angeles",
  "permalink": "https://yournetwork.mn.co/members/12345",
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-03-20T14:22:00Z"
}
```
```

--------------------------------

### Get Subscription Details

Source: https://docs.mightynetworks.com/api-reference/subscriptions/get-details-of-a-specific-payment-subscription

Retrieves the details of a specific payment subscription for a given network and subscription ID.

```APIDOC
## GET /admin/v1/networks/{network_id}/subscriptions/{id}

### Description
Retrieves the details of a specific payment subscription.

### Method
GET

### Endpoint
/admin/v1/networks/{network_id}/subscriptions/{id}

### Parameters
#### Path Parameters
- **network_id** (string | integer) - Required - The Network's unique integer ID, or subdomain.
- **id** (integer) - Required - Subscription ID

### Response
#### Success Response (200)
- **member_id** (integer) - The subscriber's integer ID
- **created_at** (string) - The date and time the subscriber was created
- **updated_at** (string) - The date and time the subscriber was last modified
- **email** (string) - The subscriber's email address
- **first_name** (string) - The subscriber's first name
- **last_name** (string) - The subscriber's last name
- **time_zone** (string) - The subscriber's time zone
- **location** (string) - The subscriber's location

#### Response Example
```json
{
  "member_id": 12345,
  "created_at": "2026-04-25T00:25:57+00:00",
  "updated_at": "2026-04-25T00:25:57+00:00",
  "email": "ada.lovelace@example.com",
  "first_name": "Ada",
  "last_name": "Lovelace",
  "time_zone": "UTC",
  "location": "London"
}
```

#### Error Response (404)
- **ErrorResponse** (object) - Indicates that the subscription was not found.
```

--------------------------------

### POST /admin/v1/networks/{network_id}/plans/{plan_id}/invites

Source: https://docs.mightynetworks.com/api-reference/invites/create-an-invite-to-a-plan

Creates an invite for a user to join a specific plan within a network. You can invite by email or user ID.

```APIDOC
## POST /admin/v1/networks/{network_id}/plans/{plan_id}/invites

### Description
Creates an invite for a user to join a specific plan within a network. You can invite by email or user ID.

### Method
POST

### Endpoint
/admin/v1/networks/{network_id}/plans/{plan_id}/invites

### Parameters
#### Path Parameters
- **plan_id** (integer) - Required - The ID of the plan to invite to
- **network_id** (oneOf: integer, string) - Required - The Network's unique integer ID, or subdomain

#### Query Parameters
- **email** (string) - Optional - The email address to invite
- **user_id** (integer) - Optional - The user ID to invite
- **message** (string) - Optional - Optional invite message

### Responses
#### Success Response (200)
- **recipient_email** (string) - The recipients email address
- **recipient_first_name** (string) - The recipient's first name
- **recipient_last_name** (string) - The recipient's last name
- **created_at** (string) - Timestamp of creation
- **id** (integer) - Unique identifier for the invite
- **sender_id** (integer) - The ID of the user who sent the invite
- **updated_at** (string) - Timestamp of last update

#### Error Response (404)
- **message** (string) - Description of the error

#### Error Response (422)
- **message** (string) - Description of the error
```

--------------------------------

### GET /admin/v1/networks/{network_id}/tags

Source: https://docs.mightynetworks.com/api-reference/tags/return-all-tags-for-the-network

Retrieves a list of all tags associated with a specific network. Supports pagination.

```APIDOC
## GET /admin/v1/networks/{network_id}/tags

### Description
Return all tags for the network.

### Method
GET

### Endpoint
/admin/v1/networks/{network_id}/tags

### Parameters
#### Path Parameters
- **network_id** (integer|string) - Required - The Network's unique integer ID, or subdomain

#### Query Parameters
- **page** (integer) - Optional - Page number for pagination
- **per_page** (integer) - Optional - Items per page (max 100)

### Responses
#### Success Response (200)
- **tags** (array) - A paginated set of tag objects

#### Response Example
{
  "tags": [
    {
      "id": 1,
      "name": "example_tag",
      "created_at": "2023-01-01T12:00:00Z",
      "updated_at": "2023-01-01T12:00:00Z"
    }
  ],
  "pagination": {
    "total": 10,
    "per_page": 10,
    "current_page": 1,
    "last_page": 1,
    "next_page_url": null,
    "prev_page_url": null
  }
}
```

--------------------------------

### Add Delays for Rate Limiting in JavaScript

Source: https://docs.mightynetworks.com/api-pagination

Demonstrates the correct way to handle rate limits by introducing a delay between paginated requests.

```javascript
// Respect rate limits
while (hasMore) {
  await fetchPage(page);
  if (hasMore) {
    await new Promise(r => setTimeout(r, 100));
  }
  page++;
}
```

--------------------------------

### GET /admin/v1/networks/{network_id}/spaces

Source: https://docs.mightynetworks.com/api-reference/spaces/returns-a-list-of-spaces-for-the-current-network

Retrieves a list of spaces within a specified network. Supports pagination.

```APIDOC
## GET /admin/v1/networks/{network_id}/spaces

### Description
Returns a list of spaces for the current network. This endpoint is useful for retrieving all organizational units within a network.

### Method
GET

### Endpoint
/admin/v1/networks/{network_id}/spaces

### Parameters
#### Path Parameters
- **network_id** (integer | string) - Required - The Network's unique integer ID, or subdomain

#### Query Parameters
- **page** (integer) - Optional - Page number for pagination
- **per_page** (integer) - Optional - Items per page (max 100)

### Response
#### Success Response (200)
- **spaces** (array) - A paginated set of spaces

#### Response Example
{
  "spaces": [
    {
      "id": 1,
      "name": "Community",
      "description": "General discussion area"
    }
  ]
}
```

--------------------------------

### Handling Permission Errors (403)

Source: https://docs.mightynetworks.com/api-error-handling

A JavaScript example showing how to check for a 403 Forbidden status code and log an error message, advising to check token scopes or request elevated permissions.

```javascript
if (response.status === 403) {
  console.error('Insufficient permissions for this operation');
  // Check token scopes or request elevated permissions
}
```

--------------------------------

### GET /admin/v1/networks/{network_id}/polls/{id}/

Source: https://docs.mightynetworks.com/api-reference/polls/returns-details-of-a-specific-poll-or-question

Retrieves the details of a specific poll or question within a network.

```APIDOC
## GET /admin/v1/networks/{network_id}/polls/{id}/

### Description
Returns details of a specific poll or question.

### Method
GET

### Endpoint
/admin/v1/networks/{network_id}/polls/{id}/

### Parameters
#### Path Parameters
- **id** (integer) - Required - ID of the poll or question
- **network_id** (integer | string) - Required - The Network's unique integer ID, or subdomain

### Response
#### Success Response (200)
- **id** (integer) - The record's integer ID
- **created_at** (string) - The date and time the record was created
- **updated_at** (string) - The date and time the record was last modified
- **post_type** (string) - The type of post (poll or question)
- **poll_type** (string) - The specific poll type (multiple_choice_poll, hot_cold_poll, percentage_poll)
- **title** (string) - The poll question/title
- **description** (string) - The full description of the poll
- **creator** (object) - Information about the poll creator
- **comments_enabled** (boolean) - Indicates if comments are enabled for the poll
- **permalink** (string) - A unique URL for the poll
- **space** (object) - Information about the space the poll belongs to
- **status** (string) - The status of the poll (e.g., 'published', 'draft')

#### Response Example
{
  "id": 1234,
  "created_at": "2026-04-25T00:25:56+00:00",
  "updated_at": "2026-04-25T00:25:56+00:00",
  "post_type": "poll",
  "poll_type": "multiple_choice_poll",
  "title": "What is your favorite feature?",
  "description": "Select your most used feature.",
  "creator": {
    "id": 5678,
    "name": "John Doe"
  },
  "comments_enabled": true,
  "permalink": "/p/1234",
  "space": {
    "id": 9101,
    "name": "General Discussion"
  },
  "status": "published"
}

#### Error Response (404)
- **error** (object) - Details about the error
  - **code** (string) - Error code
  - **message** (string) - Error message

#### Response Example
{
  "error": {
    "code": "NOT_FOUND",
    "message": "Poll or question not found"
  }
}
```

--------------------------------

### GET /admin/v1/networks/{network_id}/plans/{id}/

Source: https://docs.mightynetworks.com/api-reference/plans/return-a-single-plan-by-id

Retrieves a specific plan by its ID within a given network.

```APIDOC
## GET /admin/v1/networks/{network_id}/plans/{id}/

### Description
Return a single plan by ID.

### Method
GET

### Endpoint
/admin/v1/networks/{network_id}/plans/{id}/

### Parameters
#### Path Parameters
- **id** (integer) - Required - The ID of the plan to retrieve
- **network_id** (integer | string) - Required - The Network's unique integer ID, or subdomain

### Response
#### Success Response (200)
- **id** (integer) - The record's integer ID
- **created_at** (string) - The date and time the record was created
- **updated_at** (string) - The date and time the record was last modified
- **name** (string) - The plan's name
- **description** (string) - The plan's description
- **status** (string) - The plan's status (visible, hidden, pending, rejected, archived, legacy)
- **pricing_type** (string) - The pricing type (free, subscription, one_time, installment, one_time_installment, token_gated, nonpaid)
- **visible_to_members** (boolean) - Indicates if the plan is visible to members

#### Response Example
{
  "example": "{\n  \"id\": 1234,\n  \"created_at\": \"2026-04-25T00:25:56+00:00\",\n  \"updated_at\": \"2026-04-25T00:25:56+00:00\",\n  \"name\": \"Pro Plan\",\n  \"description\": \"Advanced features for power users\",\n  \"status\": \"visible\",\n  \"pricing_type\": \"subscription\",\n  \"visible_to_members\": true\n}"
}

#### Error Response (404)
- **message** (string) - Description of the error

#### Response Example
{
  "example": "{\n  \"message\": \"Plan not found\"\n}"
}
```