# List securities transfers List securities transfers Endpoint: GET /securities_transfers Version: 1.78.0 Security: oauth-client-credentials ## Header parameters: - `upvest-client-id` (string, required) Tenant Client ID Example: "ebabcf4d-61c3-4942-875c-e265a7c2d062" - `authorization` (string, required) Bearer (access) token from the OAuth flow with correct scopes. https://datatracker.ietf.org/doc/html/rfc6750 Example: "Bearer c2VjcmV0Cg==" - `signature` (string, required) https://tools.ietf.org/id/draft-ietf-httpbis-message-signatures-01.html#name-the-signature-http-header - `signature-input` (string, required) https://tools.ietf.org/id/draft-ietf-httpbis-message-signatures-01.html#name-the-signature-input-http-he - `upvest-api-version` (string) Upvest API version (Note: Do not include quotation marks) Enum: "1" ## Query parameters: - `direction` (string, required) Filter the list by transfer direction. Enum: "INCOMING", "OUTGOING" - `sort` (string) Sort the result by created_at, updated_at. Enum: "created_at", "updated_at" - `order` (string) Sort order of the result list if the sort parameter is specified. Use ASC for ascending or DESC for descending sort order. Enum: "ASC", "DESC" - `offset` (integer) Use the offset argument to specify where in the list of results to start when returning items for a particular query. - `limit` (integer) Use the limit argument to specify the maximum number of items returned. - `user_id` (string) User unique identifier. - `account_id` (string) Account unique identifier. - `account_group_id` (string) Account group unique identifier. - `status` (string) Status of the securities transfer * NEW - Securities transfer is created but not started processing. * PROCESSING - Securities transfer is in processing. * SETTLED - Securities transfer was successfully settled. * CANCELLED - Securities transfer was cancelled. Enum: "NEW", "PROCESSING", "CANCELLED", "SETTLED" ## Response 200 fields (application/json): - `meta` (object, required) - `meta.offset` (integer, required) Amount of resource to offset in the response. - `meta.limit` (integer, required) Total limit of the response. - `meta.count` (integer, required) Count of the resources returned in the response. - `meta.total_count` (integer, required) Total count of all the resources. - `meta.sort` (string) The field that the list is sorted by. - `meta.order` (string) The ordering of the response. * ASC - Ascending order * DESC - Descending order Enum: "ASC", "DESC" - `data` (array, required) - `data.id` (string, required) Securities transfer request unique identifier. - `data.created_at` (string, required) Date and time when the resource was created. [RFC 3339-5](https://datatracker.ietf.org/doc/html/rfc3339#section-5.6), [ISO8601 UTC](https://www.iso.org/iso-8601-date-and-time-format.html) - `data.updated_at` (string, required) Date and time when the resource was last updated. [RFC 3339-5](https://datatracker.ietf.org/doc/html/rfc3339#section-5.6), [ISO8601 UTC](https://www.iso.org/iso-8601-date-and-time-format.html) - `data.user_id` (string, required) User unique identifier. - `data.account_id` (string, required) Account unique identifier. - `data.direction` (string, required) Direction of the securities transfer * INCOMING - Securities transfer is incoming to the user. * OUTGOING - Securities transfer is outgoing from the user. Enum: "INCOMING", "OUTGOING" - `data.status` (string, required) Status of the securities transfer * NEW - Securities transfer is created but not started processing. * PROCESSING - Securities transfer is in processing. * SETTLED - Securities transfer was successfully settled. * CANCELLED - Securities transfer was cancelled. Enum: "NEW", "PROCESSING", "SETTLED", "CANCELLED" - `data.transfer_type` (string, required) Type of the securities transfer * NO_OWNER_CHANGE - No change of ownership. Enum: "NO_OWNER_CHANGE" - `data.instrument_id` (string, required) ISIN or other identity (depends on instrument_id_type) of the security to be transferred. - `data.instrument_id_type` (string, required) Type of the instrument_id * ISIN - International Securities Identification Number Enum: "ISIN" - `data.quantity` (string, required) The quantity of instrument to move in or out. - `data.counterparty` (object, required) - `data.counterparty.bic` (string, required) Business Identifier Code (also known as SWIFT-BIC, BIC, SWIFT ID or SWIFT code) [ISO 9362](https://en.wikipedia.org/wiki/ISO_9362). - `data.counterparty.account_number` (string) The account number is composed of valid Swift charset with a max length of 28 if provided. The account number helps other brokers identify the owner of the assets. - `data.counterparty.name` (string) The name is going to be split into 4 lines of 35 characters, the split is space based. This means that even if the name is exactly 140 of length, we may drop out the last parts if they don't fit into 4x35. - `data.settlement_reference` (string, required) Unique identifier of the securities transfer set by API consumers. Useful for API consumers to build special logic on top of it. NOTE: For automatic incoming transfers where API users will subscribe to the corresponding webhook, the value is set by Upvest! - `data.trade_date` (string, required) The forecast date when the trade takes place. Date in YYYY-MM-DD format. - `data.settlement_date` (string, required) The forecast date when the settlement takes place. Date in YYYY-MM-DD format. - `data.quantity_settled` (string) The quantity of instruments settled. - `data.place_of_settlement` (string) Business Identifier Code (also known as SWIFT-BIC, BIC, SWIFT ID or SWIFT code) [ISO 9362](https://en.wikipedia.org/wiki/ISO_9362). - `data.actual_settlement_date` (string) The date when the transfer settled, only known in SETTLED status. Date in YYYY-MM-DD format. ## Response 400 fields (application/problem+json): - `type` (string, required) URL to a document describing the error condition. - `status` (integer, required) Transmission of the HTTP status code so that all information can be found in one place, but also to correct changes in the status code due to the use of proxy servers. - `title` (string) A short, human-readable title for the general error type; the title should not change for given types. - `detail` (string) A human-readable description of the specific error. - `instance` (string) This optional key may be present, with a unique URI for the specific error; this will often point to an error log for that specific response. - `request_id` (string) Correlation ID for the original request. ## Response 401 fields (application/problem+json): - `type` (string, required) URL to a document describing the error condition. - `status` (integer, required) Transmission of the HTTP status code so that all information can be found in one place, but also to correct changes in the status code due to the use of proxy servers. - `title` (string) A short, human-readable title for the general error type; the title should not change for given types. - `detail` (string) A human-readable description of the specific error. - `instance` (string) This optional key may be present, with a unique URI for the specific error; this will often point to an error log for that specific response. - `request_id` (string) Correlation ID for the original request. ## Response 403 fields (application/problem+json): - `type` (string, required) URL to a document describing the error condition. - `status` (integer, required) Transmission of the HTTP status code so that all information can be found in one place, but also to correct changes in the status code due to the use of proxy servers. - `title` (string) A short, human-readable title for the general error type; the title should not change for given types. - `detail` (string) A human-readable description of the specific error. - `instance` (string) This optional key may be present, with a unique URI for the specific error; this will often point to an error log for that specific response. - `request_id` (string) Correlation ID for the original request. ## Response 406 fields (application/problem+json): - `type` (string, required) URL to a document describing the error condition. - `status` (integer, required) Transmission of the HTTP status code so that all information can be found in one place, but also to correct changes in the status code due to the use of proxy servers. - `title` (string) A short, human-readable title for the general error type; the title should not change for given types. - `detail` (string) A human-readable description of the specific error. - `instance` (string) This optional key may be present, with a unique URI for the specific error; this will often point to an error log for that specific response. - `request_id` (string) Correlation ID for the original request. ## Response 429 fields (application/problem+json): - `type` (string, required) URL to a document describing the error condition. - `status` (integer, required) Transmission of the HTTP status code so that all information can be found in one place, but also to correct changes in the status code due to the use of proxy servers. - `title` (string) A short, human-readable title for the general error type; the title should not change for given types. - `detail` (string) A human-readable description of the specific error. - `instance` (string) This optional key may be present, with a unique URI for the specific error; this will often point to an error log for that specific response. - `request_id` (string) Correlation ID for the original request. ## Response 500 fields (application/problem+json): - `type` (string, required) URL to a document describing the error condition. - `status` (integer, required) Transmission of the HTTP status code so that all information can be found in one place, but also to correct changes in the status code due to the use of proxy servers. - `title` (string) A short, human-readable title for the general error type; the title should not change for given types. - `detail` (string) A human-readable description of the specific error. - `instance` (string) This optional key may be present, with a unique URI for the specific error; this will often point to an error log for that specific response. - `request_id` (string) Correlation ID for the original request. ## Response 503 fields (application/problem+json): - `type` (string, required) URL to a document describing the error condition. - `status` (integer, required) Transmission of the HTTP status code so that all information can be found in one place, but also to correct changes in the status code due to the use of proxy servers. - `title` (string) A short, human-readable title for the general error type; the title should not change for given types. - `detail` (string) A human-readable description of the specific error. - `instance` (string) This optional key may be present, with a unique URI for the specific error; this will often point to an error log for that specific response. - `request_id` (string) Correlation ID for the original request. ## Response 504 fields (application/problem+json): - `type` (string, required) URL to a document describing the error condition. - `status` (integer, required) Transmission of the HTTP status code so that all information can be found in one place, but also to correct changes in the status code due to the use of proxy servers. - `title` (string) A short, human-readable title for the general error type; the title should not change for given types. - `detail` (string) A human-readable description of the specific error. - `instance` (string) This optional key may be present, with a unique URI for the specific error; this will often point to an error log for that specific response. - `request_id` (string) Correlation ID for the original request.