Legacy Endpoints

This page documents legacy v1.0 API endpoints. For new integrations, use the v1.1 paginated endpoints instead.

Listing sent packages (legacy)

Tip

For better performance and more flexible querying, use the paginated Listing Sent Packages endpoint instead.

Authorized users can retrieve a list of all packages sent by a Team that they belong to, subject to the MASV access policy.

Method	Route
GET	/v1/teams/{team_id}/packages

Headers

Name	Type	Required	Description
X-API-KEY	String	Yes	API key
Content-Type	String	Yes	Must be application/json

Query parameters

Name	Type	Required	Description
expired	Boolean	No	Include expired packages. Default: true
finalized	Boolean	No	Include finalized packages. Default: true
new	Boolean	No	Include new packages. Default: false
archived	Boolean	No	Include archived packages. Default: false

URL parameters

Name	Type	Required	Description
team_id	String	Yes	The Team ID returned during auth request

Request

curl -H "X-API-KEY: $API_KEY" \
  -H "Content-Type: application/json" \
  -X GET https://api.massive.app/v1/teams/$TEAM_ID/packages

Response

After a successful request, this endpoint returns 200 OK with an array of package objects.

[
  {
    "access_token": "xxxxxxxxxxxxxxxxx",
    "created_at": "2020-10-30T17:37:00.998Z",
    "custom_expiry": true,
    "expiry": "2022-11-21T17:37:00.998Z",
    "id": "01ENX9B1J68NT9Y4QHXD7T0X6S",
    "name": "test",
    "description": "Lorem ipsum dolor sit amet",
    "contains_virus": true,
    "tag": {
      "id": "01ENX9B1JBH8A9Y4QHXD7T0X6S",
      "name": "example tag name"
    },
    "sender": "test2@test2.com",
    "state": "new",
    "teamspace_id": "01H6D3W6RM3VBKWE25AJ5ZD2X8",
    "updated_at": "2020-10-30T13:37:00.999Z"
  }
]

Property	Description
access_token	Auth token required to interact with the package
state	Package state: new, finalized, expired, or archived
contains_virus	Whether a virus was detected in the package
tag	Tag name and ID (only included if the package has a tag)
links	List of download links created for this package
teamspace_id	ID of the Teamspace the package is bound to (empty if not attached)

Listing Portals (legacy)

Tip

For better performance and more flexible querying, use the paginated Listing Portals endpoint instead.

Authorized users can list Portals under their Team(s), subject to the access policy.

Method	Route
GET	/v1/teams/{team_id}/portals

Headers

Name	Type	Required	Description
X-API-KEY	String	Yes	API key

URL parameters

Name	Type	Required	Description
team_id	String	Yes	The Team ID

Request

curl -H "X-API-KEY: $API_KEY" \
  -X GET https://api.massive.app/v1/teams/$TEAM_ID/portals

Response

After a successful request, this endpoint returns 200 OK with an array of Portal objects.

Listing Portal packages (legacy)

Tip

For better performance and more flexible querying, use the paginated Listing Portal Packages endpoint instead.

Authorized users can list packages uploaded to any Portal under their Team(s), subject to the access policy.

Method	Route
GET	/v1/portals/{portal_id}/packages

Headers

Name	Type	Required	Description
X-API-KEY	String	Yes	API key

Query parameters

Name	Type	Required	Description
expired	Boolean	No	Include expired packages
finalized	Boolean	No	Include finalized packages
new	Boolean	No	Include new packages
archived	Boolean	No	Include archived packages

Note

If none of the filter parameters are passed or all are set to 0, only packages in the finalized and expired states will be returned.

URL parameters

Name	Type	Required	Description
portal_id	String	Yes	The Portal ID to get packages from

Request

curl -H "X-API-KEY: $API_KEY" \
  -X GET https://api.massive.app/v1/portals/$PORTAL_ID/packages?expired=1&finalized=1&new=0

Response

After a successful request, this endpoint returns 200 OK with an array of package objects.