Skip to content
Open Podcast API

Retrieve all updated subscription information

GET
/v1/subscriptions

Retrieve all subscription information that has changed since the provided timestamp

Authorizations

Parameters

Query Parameters

since
string format: date-time
Example
2022-04-23T18:25:43.511Z
page
number
Example
1
per_page
number
Example
5

Responses

200

Successful operation

object
total
required
number
page
required
number
per_page
required
number
next
string format: url
previous
string format: url
subscriptions
required
Array<object>
object
feed_url
required
string format: url
guid
required
string format: guid
is_subscribed
required
boolean
subscription_changed
string format: date-time
new_guid
string format: guid
guid_changed
string format: date-time
deleted
string format: date-time 
{
  "feed_url": "https://example.com/feed2",
  "guid": "968cb508-803c-493c-8ff2-9e397dadb83c",
  "is_subscribed": true
}
{
  "total": 2,
  "page": 1,
  "per_page": 5,
  "subscriptions": [
    {
      "feed_url": "https://example.com/rss1",
      "guid": "31740ac6-e39d-49cd-9179-634bcecf4143",
      "is_subscribed": true,
      "guid_changed": "2022-09-21T10:25:32.411Z",
      "new_guid": "8d1f8f09-4f50-4327-9a63-639bfb1cbd98"
    },
    {
      "feed_url": "https://example.com/rss2",
      "guid": "968cb508-803c-493c-8ff2-9e397dadb83c",
      "is_subscribed": false,
      "subscription_changed": "2022-04-24T17:53:21.573Z",
      "deleted": "2022-04-24T17:53:21.573Z"
    }
  ]
}

401

Unauthorized

object
code
required
string
message
required
string
Example
{
  "code": 401,
  "message": "User not authorized"
}