Home
Version 3
Private Domains API

Private Domains API

Retrieve a Particular Private Domain

GET /v2/private_domains/:guid

Fields

Name Description Default Valid Values Example Values
guid The guid of the domain.
name The name of the domain.
  • example.com
  • foo.example.com
owning_organization_guid The organization that owns the domain. If not specified, the domain is shared.

Parameters

Name Description Valid Values Example Values
guid The guid of the Private Domain

Request

Headers

Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoidWFhLWlkLTE2NSIsImVtYWlsIjoiZW1haWwtMTE3QHNvbWVkb21haW4uY29tIiwic2NvcGUiOlsiY2xvdWRfY29udHJvbGxlci5hZG1pbiJdLCJhdWQiOlsiY2xvdWRfY29udHJvbGxlciJdLCJleHAiOjE0MTk5ODk5NzB9.bcdvxLCMqb8CuW-rTT_b9huJW5sCzqYmxTROSUsBiJ4
Host: example.org
Cookie: 

Route

GET /v2/private_domains/b73e8a9e-c7b8-4a8d-9c6b-2a43a649937f

cURL

curl "https://api.[your-domain.com]/v2/private_domains/b73e8a9e-c7b8-4a8d-9c6b-2a43a649937f" -X GET \
	-H "Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoidWFhLWlkLTE2NSIsImVtYWlsIjoiZW1haWwtMTE3QHNvbWVkb21haW4uY29tIiwic2NvcGUiOlsiY2xvdWRfY29udHJvbGxlci5hZG1pbiJdLCJhdWQiOlsiY2xvdWRfY29udHJvbGxlciJdLCJleHAiOjE0MTk5ODk5NzB9.bcdvxLCMqb8CuW-rTT_b9huJW5sCzqYmxTROSUsBiJ4" \
	-H "Host: example.org" \
	-H "Cookie: "

Response

Headers

Content-Type: application/json;charset=utf-8
X-VCAP-Request-ID: 3968877e-5bf4-454f-abe8-e001ef045f71
Content-Length: 418
X-Content-Type-Options: nosniff

Status

200 OK

Body

{
  "metadata": {
    "guid": "b73e8a9e-c7b8-4a8d-9c6b-2a43a649937f",
    "url": "/v2/private_domains/b73e8a9e-c7b8-4a8d-9c6b-2a43a649937f",
    "created_at": "2014-12-24T01:39:20+00:00",
    "updated_at": null
  },
  "entity": {
    "name": "vcap.me",
    "owning_organization_guid": "0aa53a0e-e737-49d4-9880-62d4eb4b7b61",
    "owning_organization_url": "/v2/organizations/0aa53a0e-e737-49d4-9880-62d4eb4b7b61"
  }
}