Link Search Menu Expand Document

Welcome to the docs page for Sandbar.

The sandbar API is built around GRPC and has a http proxy that sits in front of it, allowing it to be used either with an RPC client or an http client.

As of right now only the http endpoint is supported.

When making an HTTP request, you may use the basic auth credentials provided for your team. When specifying the media-type of the body of the request, please specify Content-Type: application/json in the request header.

If there are any questions or if you have any feedback, please reach out to our support email.

Table of contents

Service

SandbarApiService (sandbar.v0.SandbarApiService)

Data ingestion service ingests events describing change of state to / different information types.

SubmitEvents

Request type Response type
SubmitEventsRequest SubmitEventsResponse

This endpoint takes in events and processes them based on the metadata
associated with them.

SubmitEventAndGetRuleOutputs

GetEntity

Request type Response type
GetEntityRequest GetEntityResponse

This simple endpoint just takes in and returns an entity.

GetAccount

Request type Response type
GetAccountRequest GetAccountResponse

This end point is used to get information about a given account.

GetRuleOutputForEntities

This is to retrieve the set of latest rule outputs for a given entity for all rules.

GetAccountsForEntity

This endpoint retrieves all the accounts that are associated with a given entity.

GetTransactionsForEntity

This endpoint will return all the transactions for a given entity.

GetAlerts

Request type Response type
GetAlertsRequest GetAlertsResponse

This query will return a set of specified alerts.

GetInvestigations

This query will return a set of specified investigations.

GetAllInvestigations

This query will return all investigations for an entity.

CloseAlert

Request type Response type
CloseAlertRequest CloseAlertResponse

This allows a user to manually close a given alert. If this closes the last open alert in
an investigation, this call will close the enclolsed investigation as well.

CloseInvestigation

This allows a user to manually close a given investigation. This will close all enclosed
alerts that remain open.

GetRuleOutputHistoryForEntity

This is to retrieve the history of rule output for a given entity for all rules.
Entity search arg because we are essentially looking up the entity where we
then have to

CreateComment

Request type Response type
CreateCommentRequest CreateCommentResponse

Create a comment for a specified object

UpdateComment

Request type Response type
UpdateCommentRequest UpdateCommentResponse

Update the contents of an existing comment

GetCommentsForInvestigation

Retrieves all comments for the specified investigation

GetCommentsForAlert

Retrieves all comments for the specified alert

AddTagToObject

Request type Response type
AddTagToObjectRequest AddTagToObjectResponse

Associates a tag with an object (either an investigation or an alert)

RemoveTagFromObject

Removes the association between a tag and an object

GetTagsForObjects

Gets all tags associated with an object

ListTags

Request type Response type
ListTagsRequest ListTagsResponse

Lists all tags that have been associated with objects

UpdateAnalysis

Request type Response type
UpdateAnalysisRequest UpdateAnalysisResponse

Updates the analysis associated with an object (must be an investigation)

GetAnalysesForObjects

Gets the analyses associated with the specified objects

AddAttachment

Request type Response type
AddAttachmentRequest AddAttachmentResponse

Creates a link between a file and an investigation or an alert in our system.
This method returns an upload link to submit the file’s contents.

GetAttachmentDownloadUrls

Gets URLs at which the contents of previously uploaded attachments can be found

AddAttachmentToObject

Associates an attachment that has already been associated with an investigation or alert
with another such object in our system. The existing attachment can be referenced by the
Sandbar-generated unique ID returned by the AddAttachment call.

RemoveAttachmentFromObject

Removes the association between an attachment and an object. If an attachment is no longer associated
with any object, it will be deleted from our records.

GetAttachmentsForObjects

Gets all attachments associated with an object

AddManualReport

Request type Response type
AddManualReportRequest AddManualReportResponse

Adds information about a user-determined risk.

HighlightObjectForInvestigationOrAlert

Highlights an object as significant to an investigation or alert

RemoveHighlightedObject

Removes a highlighted object from an investigation or alert

GetHighlightedObjects

Lists all highlighted objects for an investigation or alert

HTTP bindings

Method Name HTTP Method Path
SubmitEvents POST /v0/submit_event
SubmitEventAndGetRuleOutputs POST /v0/submit_event_get_rule_outputs
GetEntity POST /v0/get_entity
GetAccount POST /v0/get_account
GetRuleOutputForEntities POST /v0/results_for_entities
GetAccountsForEntity POST /v0/get_accounts_for_entity
GetTransactionsForEntity POST /v0/get_transactions_for_entity
GetAlerts POST /v0/get_alerts
GetInvestigations POST /v0/get_investigations
GetAllInvestigations POST /v0/get_all_investigations
CloseAlert POST /v0/close_alert
CloseInvestigation POST /v0/close_investigation
GetRuleOutputHistoryForEntity POST /v0/results_history_for_entity
CreateComment POST /v0/create_comment
UpdateComment POST /v0/update_comment
GetCommentsForInvestigation POST /v0/comments_for_investigation
GetCommentsForAlert POST /v0/comments_for_alert
AddTagToObject POST /v0/add_tag_to_object
RemoveTagFromObject POST /v0/remove_tag_from_object
GetTagsForObjects POST /v0/get_tags_for_objects
ListTags POST /v0/list_tags
UpdateAnalysis POST /v0/update_analysis
GetAnalysesForObjects POST /v0/get_analysis_for_objects
AddAttachment POST /v0/add_attachment
GetAttachmentDownloadUrls POST /v0/get_attachment_download_urls
AddAttachmentToObject POST /v0/add_attachment_to_object
RemoveAttachmentFromObject POST /v0/remove_attachment_from_object
GetAttachmentsForObjects POST /v0/get_attachments_for_objects
AddManualReport POST /v0/add_manual_report
HighlightObjectForInvestigationOrAlert POST /v0/highlight_object_for_investigation_or_alert
RemoveHighlightedObject POST /v0/remove_highlighted_object
GetHighlightedObjects POST /v0/get_highlighted_objects

Messages

Account (sandbar.v0.Account)

Object containing info about an account.

Field Type Description
optional
sandbar_account_id
optional string A sandbar ID for a given account.
account_identifier AccountIdentifier The information used to uniquely identify an account at a given point in time.
account_type AccountType The type of account.
optional
crypto_wallet_address
optional string If an account contains crypto-currency, this is the wallet’s unique identifier
optional
crypto_currency
optional string The type of crypto held in this wallet.
optional
account_open_date
optional string The date a given account was opened.
optional
account_close_date
optional string The date a given account was closed.

Account-Entity Links

Field Type Description
optional
sandbar_link_id
optional string Sandbar ID for the given link. Expected in any change or delete event, but not in a create event.
oneof account_id
source_account_identifier
AccountIdentifier Expect to see either this or sandbar_account_id. Identifying information for an account from client system.
oneof account_id
sandbar_account_id
string Expect to see either this or source_account_identifier. Identifying information for an account from sandbar system.
entity_id EntityQueryIdParam Information uniquely identifying an entity.
start_date string The date the account is linked to the entity.
optional
end_date
optional string The date the account is unlinked from the entity.
optional
description
optional string Free text field with information about the link.

AccountIdentifier (sandbar.v0.AccountIdentifier)

Information sufficient to identify a given account.

Field Type Description
account_number string An account number that is at any given point in time globally unique within a given institution.
bank_name string An institution that the given account belongs to.

AccountQueryIdParam (sandbar.v0.AccountQueryIdParam)

Field Type Description
oneof id
sandbar_account_id
string A sandbar ID for a given account.
oneof id
account_identifier
AccountIdentifier The information used to uniquely identify an account at a given point in time.

AddAttachmentRequest (sandbar.v0.AddAttachmentRequest)

A request to upload a file that can be associated with other objects

Field Type Description
file_name string The name of the file
content_type string The file’s HTTP MIME type, see https://datatracker.ietf.org/doc/html/rfc6838
object_sandbar_id string The sandbar-generated unique ID of the object to associate the attachment with (must be an investigation or an alert)

AddAttachmentResponse (sandbar.v0.AddAttachmentResponse)

A response containing information about the added attachment, including a URL to upload the contents of the file to.

Field Type Description
status google.rpc.Status Information about processing the request, including any error information
attachment_sandbar_id string The sandbar-generated unique ID for the attachment
url string A URL to upload the contents of the attachment file

AddAttachmentToObjectRequest (sandbar.v0.AddAttachmentToObjectRequest)

A request to associate an attachment with an object (must be an alert or an investigation)

Field Type Description
object_sandbar_id string The sandbar-generated unique ID for the object to associate the attachment with
attachment_sandbar_id string The sandbar-generated unique ID for the attachment

AddAttachmentToObjectResponse (sandbar.v0.AddAttachmentToObjectResponse)

A response containing information about the attachment associated with an object

Field Type Description
status google.rpc.Status Information about processing the request, including any error information
attachment_object_link_sandbar_id string The sandbar-generated unique ID for the attachment-object link

AddManualReportRequest (sandbar.v0.AddManualReportRequest)

A request to add a report based on manual risk analysis At least one identifier for the reporter is required.

Field Type Description
target_sandbar_id string The sandbar-generated unique ID of the report’s investigation target, which must be an entity
optional
narrative
optional string A narrative about the nature of the risk and how it was identified
risk_level ManualReportRiskLevel A categorization of the level of risk posed
optional
reporter_name
optional string The name of the person who reported the risk
optional
reporter_id
optional string Your institution’s identifier for the person who reported the risk
optional
reporter_email_address
optional string The person who reported the risk’s email address

AddManualReportResponse (sandbar.v0.AddManualReportResponse)

A response containing the result of adding a rule output

Field Type Description
manual_report ManualReport The created manual report
message string Message containing information about the processing of the request, including error messages
and information about failure states

AddTagToObjectRequest (sandbar.v0.AddTagToObjectRequest)

A request to associate a a tag with an object (must be an alert or an investigation)

Field Type Description
subject_sandbar_id string The sandbar-generated unique ID for the object to associate the tag with
oneof tag
tag_contents
string The contents of the tag
oneof tag
tag_sandbar_id
string The sandbar-generated unique ID for an existing tag

AddTagToObjectResponse (sandbar.v0.AddTagToObjectResponse)

A response containing information about the tag associated with an object

Field Type Description
tag_object_link_sandbar_id string The sandbar-generated unique ID for the tag-object link
tag_sandbar_id string The sandbar-generated unique ID for the tag
message string Message containing information about the processing of the request, including error messages
and information about failure states of one or more request payloads.

Address (sandbar.v0.Address)

Object that keeps information about an address.

Field Type Description
optional
street_address_line_1
optional string  
optional
street_address_line_2
optional string  
optional
city
optional string  
optional
state_or_province
optional string  
optional
zip
optional string  
country string two-letter ISO3166 country code
optional
type
optional AddressType Indicates if the address is a standard address, military, PO Box, etc.

Alert (sandbar.v0.Alert)

When a rule creates an output that is deemed sufficiently risky, we create an alert. Alerts can also be created due to manually uploaded reports of potential risks. An alert groups all relevant information after the initial trigger into one place. For a single investigation, all associated manual reports will be grouped into one alert.

Field Type Description
sandbar_alert_id string Sandbar identifier for a given alert.
oneof trigger
rule_outputs
RuleOutputsForAlert Rule outputs that triggered the alert
oneof trigger
manual_reports
ManualReportsForAlert Manual reports of risk that triggered the alert
investigation_target InvestigationTarget The investigation target associated with this alert.
next_steps repeated NextStep Set of next steps a user may be able to take to help assess the risk associated with a given alert and help an analyst decide whether or not to file a SAR.
high_water_mark_risk_score double High water mark within look-back window
status InvestigationStatus The status of the investigation into the alert.

Analysis (sandbar.v0.Analysis)

Field Type Description
subject_sandbar_id string The subject’s sandbar-generated unique ID
contents string The contents of the subject’s analysis

Attachment (sandbar.v0.Attachment)

Information about an attachment uploaded to Sandbar

Field Type Description
attachment_sandbar_id string The Sandbar-generated unique ID for the attachment
file_name string The attachment’s file name
content_type string The attachment’s content type

A response containing a URL to download the contents of an attachment from.

Field Type Description
status google.rpc.Status Information about processing the request, including any error information
url string The URL at which the attachment can be downloaded.

Information about an attachment associated with an object

Field Type Description
attachment_object_link_sandbar_id string The sandbar-generated unique ID for the attachment-object link
object_sandbar_id string The sandbar-generated unique ID for the object the attachment is associated with
attachment Attachment The attachment

A list of attachment-object links

Field Type Description
status google.rpc.Status Information about processing the request, including any error information
attachment_object_links repeated AttachmentObjectLink The attachment object links

CloseAlertRequest (sandbar.v0.CloseAlertRequest)

A request to close an alert.

Field Type Description
sandbar_alert_id string Sandbar identifier of alert to be closed.

CloseAlertResponse (sandbar.v0.CloseAlertResponse)

A response carrying information about the result of a request to close an alert.

Field Type Description
result CloseResult Information about the disposition of the closed alert.
message string Message containing information about the processing of the request, including error messages
and information about failure states of one or more request payloads.

CloseInvestigationRequest (sandbar.v0.CloseInvestigationRequest)

A request to close an investigation.

Field Type Description
sandbar_investigation_id string Sandbar identifier of investigation to be closed.

CloseInvestigationResponse (sandbar.v0.CloseInvestigationResponse)

A response carrying information about the result of a request to close an investigation.

Field Type Description
result CloseResult Information about the disposition of the closed investigation.
message string Message containing information about the processing of the request, including error messages
and information about failure states of one or more request payloads.

Comment (sandbar.v0.Comment)

A user-generated comment on an object in our system

Field Type Description
sandbar_comment_id string The sandbar-generated unique id for the comment
contents string The text of the comment
subject_sandbar_id string The sandbar-generated unique ID for the object the comment references
created_time string The time the comment was first created
updated_time string The time the comment was most recently updated

CreateCommentRequest (sandbar.v0.CreateCommentRequest)

A request containing the contents of a comment and the sandbar ID and type of the object the comment is for (must be an alert or investigation)

Field Type Description
subject_sandbar_id string The sandbar ID of the subject
contents string The contents of the comment

CreateCommentResponse (sandbar.v0.CreateCommentResponse)

A response containing information about a newly created comment

Field Type Description
sandbar_comment_id string The sandbar ID of the created comment
message string Message containing information about the processing of the request, including error messages
and information about failure states of one or more request payloads.

Entity (sandbar.v0.Entity)

Object containing information about a given entity. An entity represents a person, company, or other thing that is potentially able to be an owner of an account.

Field Type Description
optional
sandbar_entity_id
optional string The sandbar ID of the given entity.
This should not be set on events submitted to sandbar for OPERATION_TYPE_CREATE.
Guaranteed to be present in the response.
optional
source_entity_id
optional string The ID of the entity in the source system.
Required for events submitted to sandbar.
Guaranteed to be present in the response if the entity is not generated.
optional
relationship_begin_date
optional string The date the relationship between this entity and the institution began.
optional
name
optional string Name of the entity.
Required for events submitted to sandbar.
Guaranteed to be present in the response if the entity is not generated.
optional
birth_incorporation_date
optional string If a person, this field contains their birthdate. If a company, the field contains the incorporation date of the entity.
Required for events submitted to sandbar.
Guaranteed to be present in the response if the entity is not generated.
optional
primary_address
optional Address The primary address of the entity. For a business, to better assess risk, using a registration address, or a P.O. box gives less information than a headquarters, or a place of operation.
Required for events submitted to sandbar.
Guaranteed to be present in the response if the entity is not generated.
optional
email
optional string Best email address to reach a client at.
optional
tax_id
optional string A tax identifier for an entity; a TIN or SSN in the U.S. would be preferred.
optional
ein
optional string Employer ID Number.
optional
naic_code
optional string For a business, the NAIC code of the industry they operate in.
A full list of NAIC classifications and descriptions can be found at https://www.census.gov/naics/2017NAICS/2017_Definition_File.pdf.
optional
website_url
optional string For a business, the website they use to operate.
optional
generated_entity_id
optional string In the event that we are working with an incomplete entity, this generated ID may be used. This field should not be set upon creation.
Sandbar will create this id on the callers behalf.
This should not be set on events submitted to sandbar for OPERATION_TYPE_CREATE if the event.incomplete is set to true.
Guaranteed to be present in the response if the entity is generated.
optional
phone_number
optional string Best phone number to reach a client at.

EntityQuery (sandbar.v0.EntityQuery)

Query containing entity information.

Field Type Description
ids repeated EntityQueryIdParam A parameter containing information needed to identify an entity.

EntityQueryIdParam (sandbar.v0.EntityQueryIdParam)

Identifying information about a given entity.

Field Type Description
oneof entity_id
sandbar_entity_id
string Sandbar entity ID, expect to see one of this, source_entity_id, or generated_entity_id.
oneof entity_id
source_entity_id
string Entity ID in the source system, expect to see one of this, sandbar_entity_id, or generated_entity_id.
oneof entity_id
generated_entity_id
string Sandbar generated ID for incomplete entities, expect to see one of this, sandbar_entity_id, or source_entity_id.

ErrorDetails (sandbar.v0.ErrorDetails)

Message containing a detailed error response

Field Type Description
details string The details of the error

Event (sandbar.v0.Event)

Field Type Description
type EventType This is an indication of the type of event that is being sent and of how the data is intended to be processed.
oneof payload
entity
Entity Entity payload for the event. The object in this field represents the state of the object at the time of the event. Expect one of this, account, transaction, or account_entity_link.
oneof payload
account
Account Account payload for the event. The object in this field represents the state of the object at the time of the event. Expect one of this, entity, transaction, or account_entity_link.
oneof payload
transaction
Transaction Transaction payload for the event. The object in this field represents the state of the object at the time of the event. Expect one of this, entity, account, or account_entity_link.
oneof payload
account_entity_link
AccountEntityLink Account entity link payload for the event. The object in this field represents the state of the object at the time of the event. Expect one of this, entity, account, or transaction.
incomplete bool We may have information about a thing that is not quite complete. It may
be missing required info. If you use this flag we will try to make a complete
item, but we will remove some of the validation and requirements that some
pieces of information must be present. We may also generate a uuid as the
source ID if one is not provided.
Incomplete items can be tracked and later appended, merged, etc. if necessary.

EventResponse (sandbar.v0.EventResponse)

Information about an event that was processed

Field Type Description
status google.rpc.Status Information about processing the request, including any error information
sandbar_id string The sandbar ID of the item created/changed/deleted by the event.
source_id string The source ID of the item created/changed/deleted by the event that the time the event was sent.
generated_id string In the event that there is an incomplete item, this is the sandbar-generated ID for the object.
event_response_type EventResponseType Specifies the type of payload that this message is in response to
request Event The event as submitted

GetAccountRequest (sandbar.v0.GetAccountRequest)

The request sent when trying to get a specific account from sandbar.

Field Type Description
id repeated AccountQueryIdParam  

GetAccountResponse (sandbar.v0.GetAccountResponse)

Response containing requested account related information and a message.

Field Type Description
accounts repeated Account Set of accounts
message string Message containing information about the processing of the request, including error messages
and information about failure states of one or more request payloads.

GetAccountsForEntityRequest (sandbar.v0.GetAccountsForEntityRequest)

A request payload that allows a user to get a set of accounts for a given entity.

Field Type Description
id EntityQueryIdParam Information about the entity qe are trying to get accounts for.

GetAccountsForEntityResponse (sandbar.v0.GetAccountsForEntityResponse)

A response payload that contains information about a set of accounts owned by a single entity.

Field Type Description
accounts repeated Account Set of accounts
message string Message containing information about the processing of the request, including error messages
and information about failure states of one or more request payloads.

GetAlertsRequest (sandbar.v0.GetAlertsRequest)

Request for one or more alerts.

Field Type Description
sandbar_alert_id repeated string Sandbar IDs for requested alerts.

GetAlertsResponse (sandbar.v0.GetAlertsResponse)

Response containing requested alerts.

Field Type Description
alerts repeated Alert Requested alerts.
message string Message containing information about the processing of the request, including error messages
and information about failure states of one or more request payloads.

GetAllInvestigationsRequest (sandbar.v0.GetAllInvestigationsRequest)

An unfiltered request for investigations.

Field Type Description
optional
options
optional GetAllInvestigationsRequest.Options Options for a given investigation request.

GetAllInvestigationsRequest.Options (sandbar.v0.GetAllInvestigationsRequest.Options)

Options for the investigation request.

Field Type Description
include_closed bool If set to true, the response will include closed investigations.

GetAllInvestigationsResponse (sandbar.v0.GetAllInvestigationsResponse)

A response sent in response to a request for all investigations.

Field Type Description
investigations repeated Investigation The set of requested investigations.
message string Message containing information about the processing of the request, including error messages
and information about failure states of one or more request payloads.

GetAnalysesForObjectsRequest (sandbar.v0.GetAnalysesForObjectsRequest)

A request for the analyses for one or more objects

Field Type Description
subject_sandbar_ids repeated string The sandbar-generated unique IDs of the objects

GetAnalysesForObjectsResponse (sandbar.v0.GetAnalysesForObjectsResponse)

A response containing the analyses for the specified objects.

Field Type Description
analyses_by_subject_sandbar_id map GetAnalysesForObjectsResponse.AnalysesBySubjectSandbarIdEntry A mapping between objects’ unique sandbar-generated IDs and the analyses associated with them
message string Message containing information about the processing of the request, including error messages
and information about failure states.

GetAnalysesForObjectsResponse.AnalysesBySubjectSandbarIdEntry (sandbar.v0.GetAnalysesForObjectsResponse.AnalysesBySubjectSandbarIdEntry)

Field Type Description
key string  
value Analysis  

GetAttachmentDownloadUrlsRequest (sandbar.v0.GetAttachmentDownloadUrlsRequest)

A request for a link that can be used to download previously uploaded attachments

Field Type Description
attachment_sandbar_ids repeated string The sandbar-generated unique ID of the attachment

GetAttachmentDownloadUrlsResponse (sandbar.v0.GetAttachmentDownloadUrlsResponse)

A response containing URLs for retrieving the contents of previously uploaded attachments.

Field Type Description
status google.rpc.Status Information about processing the request, including any error information
urls_by_attachment_sandbar_id map GetAttachmentDownloadUrlsResponse.UrlsByAttachmentSandbarIdEntry A mapping between attachment’s sandbar-generated unique IDs and URLs at which their contents can be found

GetAttachmentDownloadUrlsResponse.UrlsByAttachmentSandbarIdEntry (sandbar.v0.GetAttachmentDownloadUrlsResponse.UrlsByAttachmentSandbarIdEntry)

Field Type Description
key string  
value AttachmentDownloadLink  

GetAttachmentsForObjectsRequest (sandbar.v0.GetAttachmentsForObjectsRequest)

A request for all attachments associated with the specified objects

Field Type Description
object_sandbar_ids repeated string The sandbar-generated unique IDs of the objects

GetAttachmentsForObjectsResponse (sandbar.v0.GetAttachmentsForObjectsResponse)

A response containing all attachments for objects, indexed by the sandbar-generated unique ID for each object

Field Type Description
status google.rpc.Status Information about processing the request, including any error information
attachments_by_subject_sandbar_id map GetAttachmentsForObjectsResponse.AttachmentsBySubjectSandbarIdEntry A mapping between objects’ unique sandbar-generated IDs and a list of attachments associated with them

GetAttachmentsForObjectsResponse.AttachmentsBySubjectSandbarIdEntry (sandbar.v0.GetAttachmentsForObjectsResponse.AttachmentsBySubjectSandbarIdEntry)

Field Type Description
key string  
value AttachmentObjectLinkList  

GetCommentsForAlertRequest (sandbar.v0.GetCommentsForAlertRequest)

A request for all comments associated with an alert

Field Type Description
sandbar_alert_id string The sandbar ID of the alert to fetch comments for

GetCommentsForAlertResponse (sandbar.v0.GetCommentsForAlertResponse)

A response containing all comments for the requested alert

Field Type Description
comments repeated Comment All comments on the alert
message string Message containing information about the processing of the request, including error messages
and information about failure states of one or more request payloads.

GetCommentsForInvestigationRequest (sandbar.v0.GetCommentsForInvestigationRequest)

A request for all comments associated with an investigation

Field Type Description
sandbar_investigation_id string The sandbar ID of the investigation to fetch comments for

GetCommentsForInvestigationResponse (sandbar.v0.GetCommentsForInvestigationResponse)

A response containing all comments for the requested investigation

Field Type Description
comments repeated Comment All comments on the investigation
message string Message containing information about the processing of the request, including error messages
and information about failure states of one or more request payloads.

GetEntityRequest (sandbar.v0.GetEntityRequest)

A request containing information necessary to get a given entity.

Field Type Description
request EntityQuery Specifies entities to request detailed information on.

GetEntityResponse (sandbar.v0.GetEntityResponse)

A response containing requested entity information.

Field Type Description
entity repeated Entity Contents the entities requested.
message string Message containing information about the processing of the request, including error messages
and information about failure states of one or more request payloads.

GetHighlightedObjectsRequest (sandbar.v0.GetHighlightedObjectsRequest)

A request to get all objects highlighted for an investigation or alert

Field Type Description
investigation_alert_sandbar_id string The sandbar-generated unique ID for the investigation or alert

GetHighlightedObjectsResponse (sandbar.v0.GetHighlightedObjectsResponse)

A response containing the objects highlighted for an investigation or alert

Field Type Description
object_sandbar_ids repeated string The sandbar-generated unique ID of the highlighted objects
message string Message containing information about the processing of the request, including error messages
and information about failure states

GetInvestigationsRequest (sandbar.v0.GetInvestigationsRequest)

A request for a set of investigations

Field Type Description
sandbar_investigation_id repeated string Sandbar IDs of investigations to request detailed information on.

GetInvestigationsResponse (sandbar.v0.GetInvestigationsResponse)

A response containing the requested set of investigations.

Field Type Description
investigation repeated Investigation Set of requested investigations.
message string Message containing information about the processing of the request, including error messages
and information about failure states of one or more request payloads.

GetRuleOutputForEntitiesRequest (sandbar.v0.GetRuleOutputForEntitiesRequest)

A request containing information necessary to get rule outputs for a given entity.

Field Type Description
request EntityQuery Specifies which entities to request for rule outputs for.

GetRuleOutputForEntitiesResponse (sandbar.v0.GetRuleOutputForEntitiesResponse)

Field Type Description
responses repeated RuleOutputResponse Requested rule outputs.
message string Message containing information about the processing of the request, including error messages
and information about failure states of one or more request payloads.

GetRuleOutputHistoryForEntityRequest (sandbar.v0.GetRuleOutputHistoryForEntityRequest)

A request payload that contains entity information used to get rule output history for that entity.

Field Type Description
id EntityQueryIdParam Specifies the entity to request information on.

GetRuleOutputHistoryForEntityResponse (sandbar.v0.GetRuleOutputHistoryForEntityResponse)

A message containing a history of rule outputs for a given entity.

Field Type Description
response RuleOutputResponse All rule outputs generated throughout history for a given entity.
message string Message containing information about the processing of the request, including error messages
and information about failure states of one or more request payloads.

GetTagsForObjectsRequest (sandbar.v0.GetTagsForObjectsRequest)

A request for all tags associated with the specified objects

Field Type Description
subject_sandbar_ids repeated string The sandbar-generated unique IDs of the objects

GetTagsForObjectsResponse (sandbar.v0.GetTagsForObjectsResponse)

Field Type Description
tags_by_subject_sandbar_id map GetTagsForObjectsResponse.TagsBySubjectSandbarIdEntry A mapping between objects’ unique sandbar-generated IDs and a list of tags associated with them
message string Message containing information about the processing of the request, including error messages
and information about failure states of one or more request payloads.

GetTagsForObjectsResponse.TagsBySubjectSandbarIdEntry (sandbar.v0.GetTagsForObjectsResponse.TagsBySubjectSandbarIdEntry)

Field Type Description
key string  
value TagObjectLinkList  

GetTransactionsForEntityRequest (sandbar.v0.GetTransactionsForEntityRequest)

A request that allows a user to get all the transactions associated with a given entity.

Field Type Description
id EntityQueryIdParam Specifies the entity to request information on.

GetTransactionsForEntityResponse (sandbar.v0.GetTransactionsForEntityResponse)

A set of transactions associated with a requested entity.

Field Type Description
transactions repeated Transaction Set of requested transactions.
message string Message containing information about the processing of the request, including error messages
and information about failure states of one or more request payloads.

HighlightObjectForInvestigationOrAlertRequest (sandbar.v0.HighlightObjectForInvestigationOrAlertRequest)

A request to highlight an object as significant to an investigation or alert

Field Type Description
object_sandbar_id string The sandbar-generated unique ID of the object to highlight. The object must be an entity, account, or transaction.
investigation_alert_sandbar_id string The sandbar-generated unique ID of the investigation or alert

HighlightObjectForInvestigationOrAlertResponse (sandbar.v0.HighlightObjectForInvestigationOrAlertResponse)

A response confirming an object was highlighted for an investigation

Field Type Description
message string Message containing information about the processing of the request, including error messages
and information about failure states

Investigation (sandbar.v0.Investigation)

An investigation is a unit of work comprised of one or more alerts. This is the thing that an analyst or a group of analysts should be working on. There may be one or more targets, and one or more types of risk topographies. By default an investigation groups alerts on a given investigation unit.

Field Type Description
sandbar_investigation_id string Sandbar ID of the given investigation.
alerts repeated Alert Set of alerts associated with the investigation.
target repeated InvestigationTarget The targets of a given investigation.
status InvestigationStatus The status of the investigation.

InvestigationTarget (sandbar.v0.InvestigationTarget)

Information about a target of an investigation.

Field Type Description
sandbar_target_id string  

ListTagsRequest (sandbar.v0.ListTagsRequest)

A request to list all tags that have been associated with objects

ListTagsResponse (sandbar.v0.ListTagsResponse)

A response containing all tags that have been associated with objects

Field Type Description
tags repeated Tag The tags
message string Message containing information about the processing of the request, including error messages
and information about failure states of one or more request payloads.

ManualReport (sandbar.v0.ManualReport)

Information about manually uploaded risk information

Field Type Description
investigation_target InvestigationTarget Identifies the investigation target the report applies to.
optional
narrative
optional string A narrative about the nature of the risk and how it was identified
risk_level ManualReportRiskLevel A categorization of the level of risk posed
optional
reporter_name
optional string The name of the person who reported the risk
optional
reporter_id
optional string Your institution’s identifier for the person who reported the risk
optional
reporter_email_address
optional string The person who reported the risk’s email address
timestamp string The time when the manual report was created
sandbar_alert_id string The sandbar-generated unique ID of the alert this manual report triggered

ManualReportsForAlert (sandbar.v0.ManualReportsForAlert)

A list of manual reports that triggered an alert

Field Type Description
manual_reports repeated ManualReport The manual reports

NextStep (sandbar.v0.NextStep)

In an Alert, a Next Step is a suggested course of action that an analyst may take to either confirm or alleviate the given described risk.

Field Type Description
description string A description of the action to be taken.

RemoveAttachmentFromObjectRequest (sandbar.v0.RemoveAttachmentFromObjectRequest)

A request to remove an association between a attachment and an object

Field Type Description
object_sandbar_id string The sandbar-generated unique ID for the object the attachment is associated with
attachment_sandbar_id string The sandbar-generated unique ID for the attachment

RemoveAttachmentFromObjectResponse (sandbar.v0.RemoveAttachmentFromObjectResponse)

A response confirming a attachment is no longer associated with an object

Field Type Description
status google.rpc.Status Information about processing the request, including any error information

RemoveHighlightedObjectRequest (sandbar.v0.RemoveHighlightedObjectRequest)

A request to remove a highlighted object from an investigation or alert

Field Type Description
object_sandbar_id string The sandbar-generated unique ID of the object
investigation_alert_sandbar_id string The sandbar-generated unique ID of the investigation or alert

RemoveHighlightedObjectResponse (sandbar.v0.RemoveHighlightedObjectResponse)

A response confirming an object is no longer highlighted for an investigation or alert

Field Type Description
message string Message containing information about the processing of the request, including error messages
and information about failure states

RemoveTagFromObjectRequest (sandbar.v0.RemoveTagFromObjectRequest)

A request to remove an association between a tag and an object

Field Type Description
subject_sandbar_id string The sandbar-generated unique ID for the object the tag is associated with
oneof tag
tag_contents
string The contents of the tag
oneof tag
tag_sandbar_id
string The sandbar-generated unique ID for an existing tag

RemoveTagFromObjectResponse (sandbar.v0.RemoveTagFromObjectResponse)

A response confirming a tag is no longer associated with an object

Field Type Description
message string Message containing information about the processing of the request, including error messages
and information about failure states of one or more request payloads.

RuleOutput (sandbar.v0.RuleOutput)

Certain actions prompt sandbar to run our suite of rules against an investigation target. Each time this happens, a rule output is generated with information about the risk assessed for that target. This object contains that information.

Field Type Description
rule string This is a unique human-readable name of a given rule.
rule_version int64 This indicates a version of the rule being run.
risk_score double A score indicating the riskiness associated with this rule output. The risk score is bounded between 0 and 100.
narrative string A narrative constructed based on the circumstances around the rule being run.
timestamp string The time when the given rule output was generated.
investigation_target InvestigationTarget Identifies the investigation target the rule ran against.

RuleOutputResponse (sandbar.v0.RuleOutputResponse)

A response containing rule outputs for a given investigation target.

Field Type Description
investigation_target InvestigationTarget Identifies the investigation target the rule ran against.
output repeated RuleOutput Rule outputs associated with the given investigation target.

RuleOutputsForAlert (sandbar.v0.RuleOutputsForAlert)

Information about a rule that triggered an alert

Field Type Description
rule_outputs repeated RuleOutput Set of rule outputs for the rule that triggered the alert
rule string A human readable name of the rule associated with the Alert. Not present if the alert is the result
of user-entered risk information.
rule_version int64 This indicates a version of a given rule that is being run.

SubmitEventAndGetRuleOutputsRequest (sandbar.v0.SubmitEventAndGetRuleOutputsRequest)

Event to be processed and have any relevant rules run.

Field Type Description
event Event Event to be processed

SubmitEventAndGetRuleOutputsResponse (sandbar.v0.SubmitEventAndGetRuleOutputsResponse)

Response from a call to submit events and get rule outputs endpoint.

Field Type Description
status google.rpc.Status Information about processing the request, including any error information
sandbar_id string The sandbar ID of the item created/changed/deleted by the event.
source_id string The source ID of the item created/changed/deleted by the event that the time the event was sent.
generated_id string In the event that there is an incomplete item, this is the sandbar-generated ID for the object.
event_response_type EventResponseType Specifies the type of payload that this message is in response to
request Event The event as submitted
rule_outputs repeated RuleOutput List of all rule outputs triggered by the event submission.

SubmitEventsRequest (sandbar.v0.SubmitEventsRequest)

Set of events to be processed and ingested by sandbar.

Field Type Description
events repeated Event List of events to be processed.

SubmitEventsResponse (sandbar.v0.SubmitEventsResponse)

Response from a call to submit events endpoint.

Field Type Description
status google.rpc.Status Information about processing the request, including any error information
responses repeated EventResponse List of responses. Not guaranteed to be in the same order as the requests.

Tag (sandbar.v0.Tag)

A tag that can be associated with an object

Field Type Description
tag_sandbar_id string The sandbar-generated unique ID for the tag
contents string The contents of the tag

Information about a tag associated with an object

Field Type Description
sandbar_id string The sandbar-generated unique ID for the tag-object link
tag_sandbar_id string The sandbar-generated unique ID for the tag
subject_sandbar_id string The sandbar-generated unique ID for the object associated with the tag
contents string The contents of the tag
time string The time the tag was associated with the object

A list of tag-object links

Field Type Description
tag_object_links repeated TagObjectLink The tag object links

TargetEntityId (sandbar.v0.TargetEntityId)

Identifying information about an entity as an Investigation Target

Field Type Description
sandbar_entity_id string Sandbar entity ID for the given investigation target.
optional
source_entity_id
optional string Entity ID in the source system for the given investigation target.
optional
generated_entity_id
optional string Sandbar generated ID for incomplete entities for the given investigation target.

Transaction (sandbar.v0.Transaction)

TRANSACTION

Field Type Description
optional
sandbar_transaction_id
optional string A transaction ID generated by Sandbar that uniquely identifies a transaction in our system.
source_transaction_id string The unique internal client ID identifying this specific transaction. This should remain unchanged across transaction states.
transaction_amount double The amount of cash moved in a given transaction.
transaction_currency string The currency of the cash that is moved in a given transaction.
account_identifier AccountIdentifier Account the transaction is associated with.
transaction_source_entity_id string A unique identifier in a source system for a given transaction. This should be consistent between any state transfers that occur for a given transaction.
optional
counterparty_source_entity_id
optional string The identifier in the source system for the transaction counterparty.
optional
counterparty_account_identifier
optional AccountIdentifier The identifier in the source system for the counterparty account.
optional
originator_to_beneficiary_information
optional string Free text field used by either party of a transaction to explain the purpose of the activity.
transaction_type TransactionType The type of the specified transaction.
execute_transaction_date_time string The date and time that a transaction was executed.
is_credit bool Field which indicates whether funds flowed into or out of the account.
optional
description
optional string Free form text field with information about a transaction.
optional
is_card_present
optional bool Indicates whether a card was present at the time of the purchase.
optional
merchant_name
optional string Name of the merchant on the transaction.
optional
settle_transaction_date_time
optional string The date and time that a transaction settles.
optional
transaction_time_zone
optional string The time zone that the transaction occurred in,
as the TZ database name that appears in the IANA time zone database.
Examples include “America/New_York” and “US/Eastern”.
optional
cvv_test
optional bool Indicates whether the cvv test was issued.
optional
ip_address
optional string The IP address from which a transaction is initiated.
optional
counterparty_swift_identifiers
optional string Swift identifiers of the counterparty bank.
optional
merchant_address
optional Address Address of the merchant on the transaction.
optional
branch_address
optional Address Address of the bank branch where the transaction occurred.
optional
atm_address
optional Address Address of the ATM where a transaction occurred.
optional
card_reference_number
optional string Single point of reference which ties together credit cards by the same issuer of the same rewards type
optional
device_imei
optional string 15 digit International Mobile Equipment Identity number that is unique to the device regardless of who manufactured it
optional
device_serial_number
optional string Unique number used by each manufacturer to identify the device
optional
device_sim
optional string Unique Subscriber Identification Module assigned to each card by the service provider
optional
instrument_serial_number
optional string Alphanumeric string that uniquely identifies the check, money order, cashier’s check, traveler’s check, etc. used in the transaction
optional
shipping_address
optional Address Shipping address associated with a given transaction.
optional
billing_address
optional Address Billing address associated with a transaction.
product_type ProductType Instrument used for the transmission of funds. See enumerated list for options and descriptions.
optional
merchant_type
optional string Merchant Category Code (MCC) number which identifies the industry of the business. List of relevant MCC codes can be found here: https://www.web-payment-software.com/online-merchant-accounts/mcc-codes/
optional
transaction_status
optional TransactionStatus The status of a transaction.
optional
transaction_source_routing_number
optional int32 The routing number associated with a given transaction.
optional
counterparty_routing_number
optional int32 The routing number associated with a counterparty in a given transaction.

UpdateAnalysisRequest (sandbar.v0.UpdateAnalysisRequest)

A request to update the contents of the analysis for an object specified by the ID.

Field Type Description
subject_sandbar_id string The subject’s sandbar-generated unique ID
contents string The new contents of the subject’s analysis

UpdateAnalysisResponse (sandbar.v0.UpdateAnalysisResponse)

A response containing the updated analysis

Field Type Description
analysis Analysis The analysis for the subject with the updated contents
message string Message containing information about the processing of the request, including error messages
and information about failure states.

UpdateCommentRequest (sandbar.v0.UpdateCommentRequest)

A request containing the updated contents of an existing comment

Field Type Description
sandbar_comment_id string The sandbar ID of the comment to update
contents string The new contents of the comment

UpdateCommentResponse (sandbar.v0.UpdateCommentResponse)

A response carrying information about the result of a request to update a comment.

Field Type Description
sandbar_comment_id string The sandbar ID of the updated comment
message string Message containing information about the processing of the request, including error messages
and information about failure states of one or more request payloads.

Enums

AccountType (sandbar.v0.AccountType)

Type of account

Name Number Description
ACCOUNT_TYPE_UNSPECIFIED 0  
ACCOUNT_TYPE_CHECKING 1 A checking account
ACCOUNT_TYPE_SAVINGS 2 A savings account
ACCOUNT_TYPE_CREDIT_CARD 3 A credit card
ACCOUNT_TYPE_BROKERAGE 4 A brokerage account, intended to hold and trade securities.
ACCOUNT_TYPE_OTHER 100 Another account type not specified here.

AddressType (sandbar.v0.AddressType)

An enum specifying the type of address being used.

Name Number Description
ADDRESS_TYPE_UNSPECIFIED 0  
ADDRESS_TYPE_RESIDENTIAL 1 A residential address, usually a home or apartment.
ADDRESS_TYPE_BUSINESS 2 A business address.
ADDRESS_TYPE_PO_BOX 3 A Post Office box.
ADDRESS_TYPE_MILITARY 4 A military address.
ADDRESS_TYPE_OTHER 100 Another address type not enumerated here.

CloseResult (sandbar.v0.CloseResult)

The various possible results of a request to close an alert or investigation.

Name Number Description
CLOSE_RESULT_UNSPECIFIED 0  
CLOSE_RESULT_SUCCESSFUL 1 The item was successfully closed.
CLOSE_RESULT_NOT_FOUND 2 The object was not found.
CLOSE_RESULT_ALREADY_CLOSED 3 The object was already closed and nothing changed.
CLOSE_RESULT_FAILED 4 There was some issue closing this item, specified in the message.
CLOSE_RESULT_OTHER 100  

EventResponseType (sandbar.v0.EventResponseType)

Specifies the type of payload that this message is in response to

Name Number Description
EVENT_RESPONSE_TYPE_UNSPECIFIED 0  
EVENT_RESPONSE_TYPE_ENTITY 1  
EVENT_RESPONSE_TYPE_ACCOUNT 2  
EVENT_RESPONSE_TYPE_ACCOUNT_ENTITY_LINK 3  
EVENT_RESPONSE_TYPE_TRANSACTION 4  

EventType (sandbar.v0.EventType)

The type of event sent over by the user.

Name Number Description
EVENT_TYPE_UNSPECIFIED 0  
EVENT_TYPE_CREATE 1 To be sent when creating a new item. If sent when an item already exists
a creation event will fail and nothing will be created in the system.
EVENT_TYPE_UPDATE 2 To be sent when updating an existing item. If the item does not exist
the update will fail and nothing will be changed in the system.
EVENT_TYPE_DELETE 3 Delete an entity. This will delete the item as of the time of the call to SubmitEvents().
If an item does not exist the delete will fail.
Please use caution with deletes. They may have some odd side effects that are not
expected as other objects referencing this object may have to continue to use
the deleted item (i.e. if an entity is deleted, an investigation on that entity
may be required to continue to exist.)

InvestigationStatus (sandbar.v0.InvestigationStatus)

The status of a given investigation.

Name Number Description
INVESTIGATION_STATUS_UNSPECIFIED 0  
INVESTIGATION_STATUS_OPEN 1 An open investigation that requires attention.
INVESTIGATION_STATUS_AUTO_CLOSED 2 An investigation that has been automatically closed by Sandbar due to its age.
INVESTIGATION_STATUS_MANUALLY_CLOSED_CLEARED 3 An investigation that has been manually closed by a user upon assessment that the activity
does not warrant a SAR filing.
INVESTIGATION_STATUS_MANUALLY_CLOSED_SUSPICIOUS 4 An investigation that has been manually closed by a user upon assessment that the activity
is suspicious and requires a SAR filing.
INVESTIGATION_STATUS_ON_HOLD 5 An investigation that is oh hold pending some internal or external action necessary
to continue the assessment.
INVESTIGATION_STATUS_IN_PROGRESS 6 An investigation that is in the process of being worked on by an investigator.
INVESTIGATION_STATUS_OTHER 100 Another investigation status that is not specified here.

ManualReportRiskLevel (sandbar.v0.ManualReportRiskLevel)

Categorizations for the level of risk for a manual report

Name Number Description
MANUAL_REPORT_RISK_LEVEL_UNSPECIFIED 0  
MANUAL_REPORT_RISK_LEVEL_LOW 1  
MANUAL_REPORT_RISK_LEVEL_MEDIUM 2  
MANUAL_REPORT_RISK_LEVEL_HIGH 3  

ProductType (sandbar.v0.ProductType)

A transaction may operate on a specific product type. This field indicates which type of product. These product types are currently derived from the product types used to file SAR forms.

Name Number Description
PRODUCT_TYPE_UNSPECIFIED 0  
PRODUCT_TYPE_US_CURRENCY 1 official government issued currency of the United States
PRODUCT_TYPE_FOREIGN_CURRENCY 3 official government issued currency of any country or jurisdiction not including the United States
PRODUCT_TYPE_CHECK 4 physical paper instrument written, dated, and signed that directs a bank to pay a specific sum of money to the bearer
PRODUCT_TYPE_WIRE 5 electronic transfer of funds across a network of banks
PRODUCT_TYPE_ACH 6 electronic bank-to-bank transfers processed through the Automated Clearing House network
PRODUCT_TYPE_ELECTRONIC_FUNDS_TRANSFER 7 electronic transfer of money over an online network
PRODUCT_TYPE_DEBIT_CARD 8 payment card that deducts money directly from a checking account
PRODUCT_TYPE_CREDIT_CARD 9 payments card in which charges are made against a line of credit instead of deposits
PRODUCT_TYPE_PREPAID_CARD 10 reloadable card allowing for only the amount of spending that has been deposited to the account
PRODUCT_TYPE_MONEY_ORDER 11 certificate, usually issued by a government or banking institution, that allows the stated payee to receive cash on demand
PRODUCT_TYPE_CASHIER_CHECK 12 certificate, issued by a banking institution, that allows the stated payee to receive cash on demand
PRODUCT_TYPE_TRAVELER_CHECK 13 physical paper instrument with a fixed amount typically used by people on vacation in foreign countries
PRODUCT_TYPE_COMMERCIAL_PAPER 14 short-term unsecured promissory notes issued by companies
PRODUCT_TYPE_STOCKS 15 certificates that assign ownership of a public company
PRODUCT_TYPE_BOND_NOTE 16 fixed income instrument which represents a loan made by an investor to a borrower
PRODUCT_TYPE_COMMERCIAL_MORTGAGE 17 mortgage loan secured by a commercial property
PRODUCT_TYPE_MORTGAGE 18 loan that the borrower uses to purchase or maintain a home or other form of real estate and agrees to pay back over time
PRODUCT_TYPE_FUTURES 19 legal agreement to buy or sell a particular commodity asset, or security at a predetermined price at a specified time in the future
PRODUCT_TYPE_INSURANCE 20 policy where an individual or entity receives financial protection or reimbursement against losses
PRODUCT_TYPE_MUTUAL_FUND 21 investment vehicle that pools money from investors to purchase a variety of different assets
PRODUCT_TYPE_OPTION 22 derivative instrument that allows, but does not obligate, the holder to buy or sell the underlying asset
PRODUCT_TYPE_MICROCAP_SECURITY 23 equity of a public company with low market capitalization value, usually below $300MM
PRODUCT_TYPE_DERIVATIVE 24 security with a value that is reliant upon or derived from, an underlying asset or group of assets
PRODUCT_TYPE_GAMING_INSTRUMENT 25 issued by a casino or card club which denotes the convertable amount to USD
PRODUCT_TYPE_OTHER 100 Another product type that is not enumerated here.

TransactionStatus (sandbar.v0.TransactionStatus)

A transaction may go through many different states in its lifetime. This represents the different stages of a life cycle. A user may update the state on a single transaction over time as it transitions.

Name Number Description
TRANSACTION_STATUS_UNSPECIFIED 0  
TRANSACTION_STATUS_INITIATED 1 A transaction that has been initiated but not yet confirmed. Can be ignored in many calculations if never finished.
TRANSACTION_STATUS_PROCESSING 2  
TRANSACTION_STATUS_FINISHED 3 For most transactions this should be the status that they remain in. This represents a transaction that has been
processed and is now final.
TRANSACTION_STATUS_DECLINED 4 A transaction that has been declined by the processor.
TRANSACTION_STATUS_VOIDED 5 A transaction that has been voided by the user.
TRANSACTION_STATUS_RETURNED 6 A transaction that has been returned.
TRANSACTION_STATUS_OTHER 100  

TransactionType (sandbar.v0.TransactionType)

Each transaction must specify a transaction type to indicate how money was moved. These are presently derived from the transaction types used to file SAR forms.

Name Number Description
TRANSACTION_TYPE_UNSPECIFIED 0  
TRANSACTION_TYPE_WITHDRAWAL 1 Results in a decrease to the balance of the account
TRANSACTION_TYPE_DEPOSIT 2 Results in an increase to the balance of the account
TRANSACTION_TYPE_CURRENCY_EXCHANGE 3 Exchange of funds between two different government issued currencies
TRANSACTION_TYPE_CASH_EXCHANGE 4 Exchange of denominations in physical cash or coins
TRANSACTION_TYPE_FEES 5 Price charged for a specific service
TRANSACTION_TYPE_TAXES 6 Compulsory contribution to state revenue, levied by the government on workers’ income and business profits
TRANSACTION_TYPE_LIENS 7 Claim upon a part of another’s property that arises because of an unpaid debt related to that property
TRANSACTION_TYPE_BUY 8 Instruction by an investor to a broker to acquire stock shares, bonds, or other assets
TRANSACTION_TYPE_SELL 9 Instruction by an investor to a broker to sell stock shares, bonds, or other assets
TRANSACTION_TYPE_LIMIT_ORDER 10 Uses a price to designate the least acceptable amount for the transaction to take place
TRANSACTION_TYPE_STOP_ORDER 11 Uses a price to merely trigger an actual order once the specified price has been traded
TRANSACTION_TYPE_ACCOUNT_CLOSING_DEBIT 12 Final transaction to fully zero out the account balance when closing the relationship
TRANSACTION_TYPE_P2P_PAYMENT 13 Electronic transfer of funds between two individual parties
TRANSACTION_TYPE_BANK_TRANSFER 14 Electronic transfer of funds between two financial institutions
TRANSACTION_TYPE_CRYPTO_TRANSFER 15 Electronic transfer of funds involving the exchange of cryptocurrency assets
TRANSACTION_TYPE_FOREX 16 Trade involving international currencies or their derivatives
TRANSACTION_TYPE_GOVERNMENT_PAYMENT 17 Funds distributed by a local, state, or federal agency
TRANSACTION_TYPE_SWAP 18 Derivative contract where two parties exchange the cash flows or liabilities from two different financial instruments
TRANSACTION_TYPE_OTHER 100 Another transaction type that is not enumerated here.

Scalar Value Types

.proto Type Notes
double  
float  
int32 Uses variable-length encoding. Inefficient for encoding negative numbers – if your field is likely to have negative values, use sint32 instead.
int64 Uses variable-length encoding. Inefficient for encoding negative numbers – if your field is likely to have negative values, use sint64 instead.
uint32 Uses variable-length encoding.
uint64 Uses variable-length encoding.
sint32 Uses variable-length encoding. Signed int value. These more efficiently encode negative numbers than regular int32s.
sint64 Uses variable-length encoding. Signed int value. These more efficiently encode negative numbers than regular int64s.
fixed32 Always four bytes. More efficient than uint32 if values are often greater than 2^28.
fixed64 Always eight bytes. More efficient than uint64 if values are often greater than 2^56.
sfixed32 Always four bytes.
sfixed64 Always eight bytes.
bool  
string A string must always contain UTF-8 encoded or 7-bit ASCII text.
bytes May contain any arbitrary sequence of bytes.