Submit a qualified startup engagement request

POST

https://api.sureshake.com/v2/startups/{startupListingId}/engagement-requests

Path parameters

startupListingId
string
required
format: uuid

Request body JSON

Any of the following:

object
- subject
  string
  required
  maxLength: 200 · minLength: 1
- reason
  string
  required
  maxLength: 2000 · minLength: 10
- idempotencyKey
  string
  required
  format: uuid
- kind
  meeting
  required
- availability
  optional
  string
  maxLength: 500 · minLength: 1
}
object
- subject
  string
  required
  maxLength: 200 · minLength: 1
- reason
  string
  required
  maxLength: 2000 · minLength: 10
- idempotencyKey
  string
  required
  format: uuid
- kind
  report
  required
- reportId
  string
  required
  format: uuid
}
object
- subject
  string
  required
  maxLength: 200 · minLength: 1
- reason
  string
  required
  maxLength: 2000 · minLength: 10
- idempotencyKey
  string
  required
  format: uuid
- kind
  deeper_access
  required
- requestedAccessTier
  capital
  or
  diligence
  required
- desiredObservation
  string
  required
  maxLength: 500 · minLength: 1
}

Returns

201

Default Response

JSON

data
object
required
- id
  string
  required
  format: uuid
- startupListingId
  string
  required
  format: uuid
- relationshipId
  string
  required
  format: uuid
- requesterUserId
  string
  required
  minLength: 1
- requesterPrincipal
  object
  required
  type
  entity
  required
  id
  string
  required
  format: uuid
- kind
  meeting
  or
  report
  or
  deeper_access
  required
- engagementStage
  meeting
  or
  diligence
  required
- engagementEventType
  investor.meeting_requested
  or
  investor.report_requested
  or
  investor.diligence_requested
  required
- subject
  string
  required
  maxLength: 200 · minLength: 1
- reason
  string
  required
  maxLength: 2000 · minLength: 10
- availability
  string
  or null
  required
  maxLength: 500 · minLength: 1
- reportId
  string
  or null
  required
  format: uuid
- requestedAccessTier
  capital
  or
  diligence
  or null
  required
- desiredObservation
  string
  or null
  required
  maxLength: 500 · minLength: 1
- status
  pending
  or
  accepted
  or
  declined
  or
  cancelled
  required
- resolvedByUserId
  string
  or null
  required
  minLength: 1
- resolvedAt
  string
  or null
  required
  format: date-time
- resolutionNote
  string
  or null
  required
  maxLength: 2000 · minLength: 3
- createdAt
  string
  required
  format: date-time
- updatedAt
  string
  required
  format: date-time
}
meta
optional
object
- timestamp
  string
  required
  format: date-time
}

400

Default Response

JSON

error
object
required
- code
  string
  required
  Machine-readable error code (e.g., NOT_FOUND)
- message
  string
  required
  Human-readable error message
- details
  optional
  unknown
  Optional structured error details
- traceId
  optional
  string
  Unique ID for log correlation
}

401

Default Response

JSON

error
object
required
- code
  string
  required
  Machine-readable error code (e.g., NOT_FOUND)
- message
  string
  required
  Human-readable error message
- details
  optional
  unknown
  Optional structured error details
- traceId
  optional
  string
  Unique ID for log correlation
}

403

Default Response

JSON

error
object
required
- code
  string
  required
  Machine-readable error code (e.g., NOT_FOUND)
- message
  string
  required
  Human-readable error message
- details
  optional
  unknown
  Optional structured error details
- traceId
  optional
  string
  Unique ID for log correlation
}

404

Default Response

JSON

error
object
required
- code
  string
  required
  Machine-readable error code (e.g., NOT_FOUND)
- message
  string
  required
  Human-readable error message
- details
  optional
  unknown
  Optional structured error details
- traceId
  optional
  string
  Unique ID for log correlation
}

409

Default Response

JSON

error
object
required
- code
  string
  required
  Machine-readable error code (e.g., NOT_FOUND)
- message
  string
  required
  Human-readable error message
- details
  optional
  unknown
  Optional structured error details
- traceId
  optional
  string
  Unique ID for log correlation
}

500

Default Response

JSON

error
object
required
- code
  string
  required
  Machine-readable error code (e.g., NOT_FOUND)
- message
  string
  required
  Human-readable error message
- details
  optional
  unknown
  Optional structured error details
- traceId
  optional
  string
  Unique ID for log correlation
}

Submit a qualified startup engagement request

curl --request POST \
  --url 'https://api.sureshake.com/v2/startups/<startupListingId>/engagement-requests' \
  --header 'Content-Type: application/json' \
  --data '
{
  "subject": "string",
  "reason": "stringstri",
  "idempotencyKey": "0c14c6a6-6f50-4d1e-b0c4-b46ff43ba6a1",
  "kind": "meeting",
  "availability": "string"
}
'

const url = 'https://api.sureshake.com/v2/startups/<startupListingId>/engagement-requests';
const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    subject: 'string',
    reason: 'stringstri',
    idempotencyKey: '0c14c6a6-6f50-4d1e-b0c4-b46ff43ba6a1',
    kind: 'meeting',
    availability: 'string'
  })
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

import requests

url = "https://api.sureshake.com/v2/startups/<startupListingId>/engagement-requests"

payload = {
    "subject": "string",
    "reason": "stringstri",
    "idempotencyKey": "0c14c6a6-6f50-4d1e-b0c4-b46ff43ba6a1",
    "kind": "meeting",
    "availability": "string"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

Response example

{
  "data": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "startupListingId": "d16a646b-f433-44ce-aaae-42761cf79f25",
    "relationshipId": "928dd5b8-3ead-4528-bdef-9c0b867a5d7d",
    "requesterUserId": "string",
    "requesterPrincipal": {
      "type": "entity",
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
    },
    "kind": "meeting",
    "engagementStage": "meeting",
    "engagementEventType": "investor.meeting_requested",
    "subject": "string",
    "reason": "stringstri",
    "availability": "string",
    "reportId": "836df459-dc40-4aa1-972a-6eb0a864dff9",
    "requestedAccessTier": "capital",
    "desiredObservation": "string",
    "status": "pending",
    "resolvedByUserId": "string",
    "resolvedAt": "2019-08-24T14:15:22Z",
    "resolutionNote": "string",
    "createdAt": "2019-08-24T14:15:22Z",
    "updatedAt": "2019-08-24T14:15:22Z"
  },
  "meta": {
    "timestamp": "2019-08-24T14:15:22Z"
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "details": null,
    "traceId": "string"
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "details": null,
    "traceId": "string"
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "details": null,
    "traceId": "string"
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "details": null,
    "traceId": "string"
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "details": null,
    "traceId": "string"
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "details": null,
    "traceId": "string"
  }
}