POST

/v1/portfolios

Bearer*
curl --request POST \
  --url https://api.oneslipstream.com/v1/portfolios \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "My Portfolio",
  "reference": "123456789"
}'
{
  "id": "port_bPKKB3sYsukFanSsaBcMCMR2",
  "description": "My Portfolio Description",
  "metadata": {
    "internalId": "12345"
  },
  "name": "My Portfolio",
  "overdraftCutOff": "1000",
  "reference": "123456789",
  "createdAt": "2022-01-01T00:00:00.000Z"
}

Authorizations

Authorizationheaderrequired
string

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
description
string

The description of the portfolio, this is for your reference only.

metadata
object

Set of key-value pairs that you can attach to an object, useful for storing additional information about the object in a structured format

namerequired
string

The name of the portfolio, this is for your reference only.

overdraftCutOff
integer | null

The maximum overdraft amount for the portfolio before it's reported to the credit bureau. Defaults to 0.

referencerequired
string

The reference of the portfolio, this is issued by the credit bureau.

Response

200 - application/json
idrequired
string

The unique identifier for the portfolio

description
string

The description of the portfolio, this is for your reference only.

metadata
object

Set of key-value pairs that you can attach to an object, useful for storing additional information about the object in a structured format

namerequired
string

The name of the portfolio, this is for your reference only.

overdraftCutOff
integer | null

The maximum overdraft amount for the portfolio before it's reported to the credit bureau. Defaults to 0.

referencerequired
string

The reference of the portfolio, this is issued by the credit bureau.

createdAt
string

The date and time the portfolio was created