--- title: "Get Actor Details by ActorID" method: GET path: "/v1/actors/{ActorID}" tags: ["Actors"] --- # Get Actor Details by ActorID `GET /v1/actors/{ActorID}` ## Request - Base URL: `https://example.com:443` - URL: `https://example.com:443/v1/actors/{ActorID}` - Auth: none required - TypeScript: (a function with typed inputs; its response is checked against the schema) This endpoint retrieves comprehensive information about a single actor. You must specify the actor's unique identifier, `ActorID`, in the request path to obtain their full profile, including attributes. ## Path parameters - `ActorID` string, required ## Response `200` Actor details retrieved successfully. - Actors - `ParentActorID` integer, nullable: The unique identifier of the parent actor, if applicable. - `ActorID` integer, nullable: The unique identifier for this actor. - `ActorDescription` string, nullable: A brief description of the actor. - `ActorCode` integer, nullable: A unique code assigned to the actor. - `ActorAddress` string, nullable: The address associated with the actor. - `ActorContact` string, nullable: The contact details for the actor. - `ActorTypeID` integer, nullable: The identifier for the type of actor, defining the actor's role or category. - `ActorStatus` integer, nullable: The current status of the actor, represented by a status code. - `ActorHierarchyLevel` integer, nullable: The level of hierarchy where the actor is positioned within the organizational structure. - `CurrencyID` integer, nullable: The identifier for the currency used by the actor. - `LastUpdated` string, date-time, nullable: The date and time when the actor's information was last updated. - `RouteManagerName` string, nullable: The name of the route manager associated with the actor. - `RouteManagerMobile` string, nullable: The mobile number of the route manager associated with the actor. - `TimeZoneKey` integer, nullable: The key representing the time zone in which the actor operates. - `DayLightSavingsBit` boolean, nullable: Indicates whether daylight saving time is observed by the actor. - `CountryID` integer, nullable: The identifier for the country in which the actor is located. - `DailyCCTransLimitPerCard` integer, nullable: The daily credit card transaction limit per card for the actor. - `DailyPPTransLimitPerCard` integer, nullable: The daily prepaid card transaction limit per card for the actor. - `DailyExternalPPTransLimitPerCard` integer, nullable: The daily external prepaid card transaction limit per card for the actor. - `DailyCCTransLimitPerCardPerOperator` integer, nullable: The daily credit card transaction limit per card per operator for the actor. - `OperatorActorID` integer, nullable: The identifier for the operator managing this actor. - `DistributorActorID` integer, nullable: The identifier for the distributor associated with the actor. - `AreaActorID` integer, nullable: The identifier for the area actor that encompasses this actor. - `RouteActorID` integer, nullable: The identifier for the route actor associated with this actor. - `ActorHierarchy` string, nullable: The hierarchical structure to which the actor belongs. - `ActorHasChildrenBit` boolean, nullable: Indicates whether the actor has child entities. - `ActorHasMachinesBit` boolean, nullable: Indicates whether the actor is associated with any machines. - `ActorImageURL` string, nullable: The URL to an image representing the actor. - `ActorContractInfo` string, nullable: Contractual information related to the actor. - `ActorSQSID` integer, nullable: The identifier for the actor's SQS (Simple Queue Service) system, if applicable. - `UseProductGroupVATBit` boolean, nullable: Indicates whether VAT is applied based on the product group for this actor. - `EreceiptTransactionEndEnableBit` boolean, nullable: Indicates whether e-receipts are enabled for transactions ending with this actor. - `MaximumRevalueAmountLimit` number, double, nullable: The maximum amount limit for revaluing transactions for this actor. - `ActorCreatedBy` integer, nullable: The identifier of the user who created this actor's record. - `ActorCreationDate` string, date-time, nullable: The date and time when this actor was created. - `UpdateBy` integer, nullable: The identifier of the user who last updated this actor's record. - `CultureID` integer, nullable: The identifier for the culture or locale associated with the actor. - `RevaluePayoutByDistributor` boolean, nullable: Indicates whether the revalue payout is handled by the distributor. - `FiscalizationBit` boolean, nullable: Indicates whether fiscalization is enabled for this actor. - `GeoCountryID` integer, nullable: The identifier for the country based on the actor's geographic information. - `GeoState` string, nullable: The state or region based on the actor's geographic information. - `GeoCity` string, nullable: The city based on the actor's geographic information. - `GeoAddress` string, nullable: The address based on the actor's geographic information. - `GeoStreetNumber` string, nullable: The street number based on the actor's geographic information. - `GeoLongitude` number, double, nullable: The geographic longitude of the actor's location. - `GeoLatitude` number, double, nullable: The geographic latitude of the actor's location. - `GeoZipCode` string, nullable: The zip code based on the actor's geographic information. - `GeoZoom` integer, nullable: The zoom level for map-based services relevant to the actor's geographic location. - `ActorLanguageID` unknown - `ActorMerchantBit` string, nullable: Indicates whether the actor is associated with a merchant. - `ActorMerchantNameForDescriptor` string, nullable: The merchant name used for transaction descriptors related to this actor. - `OverrideGeoInherritcanceBit` boolean, nullable: Indicates whether the actor overrides inherited geographic settings. - `AirportID` integer, nullable: The identifier for the airport associated with the actor, if applicable. - `VerticalCustomJSON` string, nullable: Custom JSON data specific to the vertical market or industry the actor operates in. - `FiscalizationActorID` integer, nullable: The identifier for the actor responsible for fiscalization. - `SupportIncrementalAuth` boolean, nullable: Indicates whether incremental authorization is supported by this actor. - `MaximumDefaultCredit` number, double, nullable: The maximum default credit limit allowed for this actor. - `Refs` object, nullable: A key-value pair object containing additional references associated with the actor. --- [API](https://skmtc.dev/nayax/apis/nayax-cortina-api.md) - [All operations](https://skmtc.dev/nayax/apis/nayax-cortina-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nayax/apis/nayax-cortina-api/revisions/421f6f83c257?raw)