Skip to main content

Retrieve a Subscription

Rutuja Murumkar
Updated

This article describes the steps for retrieving a subscription in BlueDolphin.

HTTP response status code Interpretation
200 OK Subscription retrieved successfully
400 Bad Request Subscription could not be retrieved due to invalid tenant data passed
401 Unauthorized Subscription could not be retrieved due to the user not being authorized with the correct API key
404 Not Found Could not find subscription with specified ID
500 Internal Server Error The subscriptions couldn’t be retrieved due to a server error

 

Make a GET request to /subscriptions/{id}:

  • Resource/endpoint destination URL
  • The header for your API request
  • The {tenant} needs to be replaced with the tenant's name
  • The ID needs to be replaced with the ID of the subscription to retrieve
curl --location --globoff --request GET 
'https://public-api.eu.bluedolphin.app/v1/subscriptions/‘{id} \
--header 'x-api-key: YOURAPIKEYSECRET' \
--header 'tenant: tenantName' \

 

Successful response

A successful call returns a response with a 200 OK HTTP status code and the following body:

{
    "id": "Unique identifier",
    "last_updated_by": "Unique identifier",
    "url": "Unique URL provided",
    "bluedolphin_event": "Event Name",
    "object_definition_id": "000000000000000000000001",
    "workspace_id": "000000000000000000000001",
    "headers": {},
    "status": 0, 
    "http_verb": "POST"
}

 

Response properties

Property Type Description
id string Unique identifier for the subscription
last_updated_by string Unique identifier of the person who last updated/created the subscription
url string The external URL to which messages are sent
bluedolphin_event string The event name for which the subscription was created
object_definition_id string Unique identifier of the object definition that the object is based on
workspace_id string Unique identifier of the workspace where the event is located
headers object The headers are provided, if needed, to make a request to an external URL with authorization tokens
http_verb string The type of request to be made to the URL provided

Related articles

Comments

0 comments

Please sign in to leave a comment.